Indeed Skills

indeed-skills：面向 AI Agent 的 Indeed 招聘信息 API 技能

用于获取 Indeed 实时招聘信息数据的 Agent 技能。 三个即插即用的技能，可为 Claude、ChatGPT、Cursor 或任何自定义 Agent 循环提供招聘信息 API：通过 RolesAPI REST API 按关键词和地点搜索 Indeed 职位、获取标准化的职位详情，以及查询薪资、职位描述、公司信息和福利。如果你一直在寻找 Indeed API，或能返回整洁 JSON 的 Indeed 数据 API 替代方案，这是将招聘数据接入 AI Agent 的最快方式。

免费开始。获取密钥（注册即赠 100 个额度，无需信用卡），不到两分钟就能让你的 Agent 搜索实时招聘信息。

纯 Python 标准库。无依赖。采用 MIT-0 许可证。

安装

# OpenClaw (via ClawHub)
npx clawhub@latest install indeed-full

# Hermes Agent
hermes skills install skills-sh/nikhonit/indeed-skills/skills/indeed-full

# Generic agent skills (Claude Code, Cursor, Cline)
npx skills add nikhonit/indeed-skills

将 indeed-full 换成 indeed-search 或 indeed-salary，即可安装精简版。

此仓库中的技能

技能	功能	额度费用
indeed-full	完整工具包：搜索职位、通过职位键或粘贴的 URL 获取完整职位详情、薪资、职位描述、公司信息和福利部分，以及账户检查	每次调用 1 个额度
indeed-search	轻量搜索：按关键词和地点搜索职位，并提供今日发布、本周发布和仅限远程职位的预设	每页结果 1 个额度
indeed-salary	仅按职位键或粘贴的 Indeed URL 查询薪资	每次查询 1 个额度

需要广泛覆盖的 Agent 可安装 indeed-full。如果希望工具集尽可能精简，可安装精简版。

快速入门

1. 在 rolesapi.com 注册，并在 rolesapi.com/app/keys 创建密钥。免费方案包含 100 个额度，无需信用卡。
2. 导出密钥并运行脚本：

export ROLESAPI_KEY="rk_live_..."
python3 skills/indeed-search/scripts/search_listings.py "registered nurse" "Chicago, IL"

实际输出，精简至 35 条结果中的一条：

{
  "data": [
    {
      "job_key": "7dcf172c8d7fc756",
      "title": "Nursing",
      "company": { "name": "Golden Healthcare Services Inc" },
      "location": "Olympia Fields, IL 60461",
      "employment_type": "Full-time",
      "salary": { "min": 30, "max": 45, "period": "hour", "currency": "USD", "source": "employer" },
      "posted_at": "2026-06-26",
      "url": "https://www.indeed.com/viewjob?jk=7dcf172c8d7fc756"
    }
  ],
  "meta": { "count": 35 },
  "request_id": "a18e4ef88ad4b00b"
}

将任意 job_key 传入详情脚本：

python3 skills/indeed-full/scripts/get_role.py 7dcf172c8d7fc756
python3 skills/indeed-salary/scripts/get_salary.py 7dcf172c8d7fc756

完整教程：rolesapi.com 快速入门。

兼容

• Claude Code / Claude Skills：将技能文件夹放入技能目录，Claude 就会从 SKILL.md 中识别它。
• ChatGPT 和自定义 GPT：通过代码解释器调用脚本，或将其封装为操作。
• Cursor、Cline 和其他编码 Agent：这些脚本是纯 CLI 工具，因此任何能运行 Python 的 Agent 都可以使用。
• 任何 Agent 循环：每个脚本都是独立的 CLI，无需从 stdin 读取输入，并会输出 JSON，可轻松从 Node、Go 或 Rust 中通过 shell 调用。
• 零安装选项：RolesAPI 提供托管 MCP 服务 https://api.rolesapi.com/mcp。将 MCP 客户端指向该服务，即可完全跳过脚本。

此外还有 llms.txt（以及 llms-full.txt），方便你将整个 API 功能集交给模型。

返回内容

覆盖 60 多个 Indeed 国家/地区版本的标准化职位对象：职位名称、含评分的公司信息、地点、雇佣类型、薪资（最低值、最高值、货币、周期、雇主提供或估算）、福利、完整职位描述、发布日期和规范 URL。每个响应都采用 { "data": ..., "request_id": "..." } 格式的信封。请参阅 roles API 文档、search API 文档、listings API 文档 和 OpenAPI 规范。

批量处理时，API 还支持异步搜索，并可为每个任务批量补充最多 500 条招聘信息的数据；完成事件会通过签名 Webhook 发送。

身份验证

将环境变量 ROLESAPI_KEY 设置为你的 RolesAPI 密钥（格式为 rk_live_...）。

export ROLESAPI_KEY="rk_live_..."

获取免费密钥：注册即可获得 100 个积分，无需银行卡。同一个密钥可用于这些技能、托管的 MCP 服务和直接 REST 调用。

定价

方案	价格	积分	速率限制
免费	$0	100（注册时一次性发放）	20/min
月付	$5/mo	1,000/month	200/min
年付	$54/yr	12,000 upfront	300/min

每个职位详情或一页搜索结果消耗 1 个积分。失败的调用不收费。完整定价：rolesapi.com/pricing。

常见问题

如何将 Indeed 招聘信息获取为 JSON？ 在 rolesapi.com 注册，导出 ROLESAPI_KEY，然后调用 GET /v1/listings?keyword=...&location=...（或运行此仓库中的 search_listings.py）。你将获得经过规范化的 JSON 职位摘要，其中包含用于后续详情调用的职位密钥。

有免费的 Indeed 招聘 API 吗？ RolesAPI 免费方案在注册时提供 100 个积分，无需银行卡，足以进行 100 次搜索或职位查询。付费方案起价为 $5/月，可获得 1,000 个积分。

费用是多少？ 每个职位详情或一页搜索结果消耗 1 个积分。$5/月可获得 1,000 个积分，或 $54/年可获得 12,000 个积分。失败的调用不收费。

在美国境外也能使用吗？ 可以。传入 --country（例如 gb、de、in）即可搜索 60 多个 Indeed 国家站点中的任意一个。

能获取某个 Indeed 招聘信息的薪资吗？ 可以。GET /v1/roles/{job_key}/salary 会返回最低薪资、最高薪资、货币、薪资周期，以及薪资数据是来自雇主还是估算值。indeed-salary 技能封装了这一功能，也接受粘贴的 Indeed URL。

我的 Agent 能否无需安装任何东西就使用它？ 可以。将 MCP 客户端指向托管服务 https://api.rolesapi.com/mcp，即可使用相同的搜索和职位工具，无需安装。

这是官方 Indeed API 吗？ 不是。RolesAPI 是一款独立产品。请参阅下方免责声明。

问题与贡献

请参阅 CONTRIBUTING.md。安全问题报告：SECURITY.md。

许可证

MIT No Attribution。可分叉、发布和再授权，无需署名。

免责声明

RolesAPI 是一款独立产品，与 Indeed 无关联，也未获 Indeed 背书或赞助。Indeed 是其所有者的商标。