无论你是在追踪谁在招人、做薪资对标、为招聘网站提供数据,还是在寻找自由职业项目,都需要结构化的最新职位数据。Lovely Router 就是这样一个职位数据 API:它会搜索 LinkedIn、Indeed、Glassdoor、Upwork 以及企业自己的招聘官网,把每个职位以 JSON 返回:职位名称、公司、地点和发布日期,数据源提供时还包括薪资和完整的职位描述。按返回的职位数付费,费用从与模型共用的同一个预付费密钥中扣除。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
Collect job postings from LinkedIn, Indeed, Glassdoor, Upwork and company career sites, plus public LinkedIn profiles. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the roles, locations, companies and the fields you need>工作原理
描述搜索条件
一个职位名称或技能、一个地点、一个时间范围。部分工具还支持按公司、经验级别或付款认证状态筛选。
设置上限后运行
把输入连同
max_results发送到POST /v1/tools/{id}/run。这个上限也是这次运行最多能计费的数量,同时它会限制工具自身的limit字段,所以不需要两个都设置。存储并重复运行
保存每个职位,然后每天或每小时用较短的时间范围重新运行同样的搜索,只获取新发布的职位。
一次请求搜索 LinkedIn 职位
LinkedIn 职位支持按职位名称、技能或公司以及地点搜索。下面这次运行会返回最多 50 个最近一周在纽约发布的软件工程职位:
curl https://lovelyrouter.com/v1/tools/linkedin-jobs/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"keywords": "software engineer",
"location": "New York",
"datePosted": "r604800",
"limit": 50
},
"max_results": 50
}'items 中的每个职位都包含职位名称、公司、地点、薪资、发布日期、申请人数和职位描述。datePosted 可以取 r86400(24 小时)、r604800(一周)或 r2592000(一个月),companyName 可以把搜索范围缩小到一组公司。运行超过 60 秒仍未结束时会返回 202;轮询方法见运行工具。
工具一览
来自 LinkedIn 职位搜索 URL 的招聘信息:职位、公司、地点、发布日期、描述。
按职位名称和地点获取 Indeed 招聘信息:公司、薪资、发布日期、描述。
按关键词和地点获取 Glassdoor 招聘信息。
Upwork 上的自由职业项目:标题、预算或时薪、技能、客户记录、发布时间。
直接来自企业招聘官网和 ATS(Greenhouse、Lever、Workday 等)的最新职位,可按职位、地点和公司搜索。
按 URL 获取公开的 LinkedIn 个人资料:头衔、工作经历、教育、技能、所在地。
| 工具 | 你发送的内容 | 每条结果包含 |
|---|---|---|
linkedin-jobs | keywords、location、datePosted、companyName | 职位名称、公司、地点、薪资、发布日期、申请人数、职位描述 |
indeed-jobs | title、location(或 "remote")、country、datePosted(天数) | 公司、薪资、发布日期、职位描述 |
glassdoor-jobs | keywords、location(两者均为必填)、daysOld | 一个 Glassdoor 职位 |
upwork-jobs | query、experienceLevel、jobType、paymentVerified、sort | 项目名称、预算或费率、技能要求、客户历史、发布时间 |
career-site-jobs | titleSearch、locationSearch、organizationSearch、timeRange | 来自企业招聘官网或招聘管理系统的一个职位 |
linkedin-profile | urls 或 publicIdentifiers | 个人简介标题、工作经历、教育背景、技能、所在地 |
企业招聘官网职位直接从企业自己的招聘官网,以及 Greenhouse、Lever、Workday 等招聘管理系统读取职位。它的 titleSearch 和 organizationSearch 支持用 :* 做前缀匹配("Data:*"),locationSearch 则需要使用英文的精确格式 "City, State/Region, Country",美国的州名要写全称:"Austin, Texas, United States"。
实用配方
把 "companyName" 设为你的目标客户,并设置 "datePosted": "r604800",运行 linkedin-jobs。一家本周在招三名数据工程师的公司就是一条热线索;结合销售线索挖掘工具找到合适的联系人。
对你招聘所在的每个城市,用 "title": "data analyst" 运行 indeed-jobs,保留标明薪资的职位,按地点比较薪资范围。
每天在同一时间用 "timeRange": "24h" 和 "titleSearch": ["Data Engineer"] 运行一次 career-site-jobs。该工具自身的建议是每小时、每天或每周在同一时间运行,这样能拿到所有职位且不重复;刚开始时用 "6m" 可以补齐所有在招职位。
每小时用 "query": "web scraping"、"paymentVerified": true 和 "sort": "newest" 运行 upwork-jobs,把新项目连同预算和客户历史推送给你的团队。
对于一份公开 LinkedIn 个人主页 URL 的候选名单,linkedin-profile 一次运行就能返回每个人的个人简介标题、工作经历、教育背景和技能。
个人数据
LinkedIn 个人主页以及写明招聘人员姓名的职位信息都包含个人数据。你有责任依法使用这些数据,例如在适用时遵守 GDPR 或 CCPA;可接受使用政策禁止利用结果对个人进行画像或歧视。
你的智能体也能运行同样的搜索。连接 MCP 服务器,然后对它说:"查找最近 24 小时内在 LinkedIn 和 Indeed 上发布的远程高级 Python 职位,去掉重复项,给我一张包含职位名称、公司、薪资和链接的表格。每次运行都设置 max_results。"
常见问题
能按日期和公司筛选 LinkedIn 职位吗?+
可以。linkedin-jobs 工具支持用 datePosted 筛选最近 24 小时、一周或一个月内的职位,支持 companyName 公司列表,地点可以是城市、州或邮政编码。
覆盖哪些职位来源?+
LinkedIn、Indeed、Glassdoor 和 Upwork,以及通过 career-site-jobs 工具覆盖的企业招聘官网和招聘管理系统。每个来源都是一个独立的工具,用同一个 API 密钥调用。
如何每天只获取新发布的职位?+
使用每个工具的时间筛选条件,并每天在同一时间运行:LinkedIn 用 datePosted r86400,Indeed 用 datePosted 1,Glassdoor 用 daysOld 1,企业招聘官网用 timeRange 24h,Upwork 按 newest 排序。记录已经看过的职位,在下一次运行时跳过它们。
职位信息包含薪资吗?+
LinkedIn 和 Indeed 的结果包含薪资字段,职位写明薪资时会填入。Upwork 项目附带预算或时薪。
能查询候选人的 LinkedIn 个人主页吗?+
可以,使用 linkedin-profile 工具并提供个人主页 URL 或公开标识符即可。它会返回公开的个人主页信息:个人简介标题、工作经历、教育背景、技能和所在地。你有责任确保处理这些数据有合法理由。
需要 LinkedIn 或 Indeed 账号吗?+
输入中不涉及这些网站的任何账号。你用 Lovely Router API 密钥调用每个工具,输入是包含搜索词或 URL 的 JSON。