用途
indeed-mcp 是一个托管的 Model Context Protocol（MCP）服务器，让 AI 客户端能够调用两个只读的 Indeed 工具：按关键词与地点搜索职位列表，以及读取单条职位全文。所有数据以结构化 JSON 返回。它读取的是未登录访客可见的公开职位信息，无需 Indeed 开发者账号，也无需合作伙伴审批。
主要能力
服务器暴露两个工具：
- hasdata_indeed_listing_getJobListings：按关键词和地点返回一页搜索结果，包含 searchInformation、jobs 数组、peopleAlsoSearchFor 及分页信息（nextPage 为下一页 URL）。每条职位包含 title、company、location、url、简短描述、sponsored、相对日期与绝对 isoDate、details 数组（如 Full-time、Hybrid work）、benefits 数组，以及当职位标明薪资时的 salary 对象。
- hasdata_indeed_job_getJobDetails：根据职位 URL 返回完整招聘信息，包含 title、company、location、sponsored、details 对象（含 jobType 与 workSetting 数组）、salary 对象（如存在），以及职位正文的 description（纯文本）和 descriptionHtml（保留列表与段落标记）。 此外，服务器提供一个预置 prompt（现成工作流），并暴露 4 个资源，每个对应一个参数，其可接受值为固定列表，URI 格式为 hasdata://indeed/<parameter>，读取资源不消耗积分。
使用方式
需要一个 MCP 客户端，以及从 HasData 仪表板获取的 API Key（免费创建，无需信用卡）。这是一个远程服务器，最简单的方式是通过 URL 和 x-api-key 请求头连接，无需运行容器，也无需 Indeed 开发者账号。仅支持 stdio 的客户端可通过轻量启动器接入，启动器已发布为 npm 包 @hasdata/indeed-mcp 和 PyPI 包 hasdata-indeed-mcp。服务器 URL 对所有客户端相同：https://mcp.hasdata.com/mcp?apis=indeed。 支持 OAuth 的客户端可将该 URL 添加为连接器并登录，无需在配置文件中放置密钥（设置 → 连接器 → 添加自定义连接器，粘贴 URL 并登录）。Claude Desktop 仅加载本地（stdio）服务器，因此通过 stdio 启动器访问远程服务器，该启动器从环境变量读取密钥，需添加到 claude_desktop_config.json。使用 Python 时，可换用 PyPI 包，用 uvx 运行无需手动安装。Cursor 使用 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（单项目）。Windsurf 使用 ~/.codeium/windsurf/mcp_config.json，字段名为 serverUrl 而非 url。VS Code 使用工作区中的 .vscode/mcp.json。 用户只需粘贴 prompt，代理会自动选择工具。
适用场景
适合需要让 AI 代理检索 Indeed 公开职位信息、比较薪资、提取职位全文的应用，例如求职辅助、招聘市场分析或职位聚合。
限制
- 仅只读，不提供职位申请、雇主仪表板、候选人数据或私有职位。
- 只读取公开可见的职位页面。
- 每次成功调用消耗 10 积分，与响应大小无关。免费层每月 1000 积分（约 100 次调用），无需信用卡，按账单周期续期；付费计划起价 $59/月，包含 200,000 积分（约 20,000 次调用），单价随用量下降，具体价格见定价页面。计划也决定并发：免费层允许 1 个并发请求，Startup 为 5，Basic 为 15，Growth 层级从 50 到 500。非 200 响应不计费，但成功但无结果的调用仍计费。
- 错误处理：客户端几乎不会从工具调用看到 HTTP 错误码，MCP 层返回 200 并将失败放在结果中，isError 为 true，原因为文本。错误的密钥表现为工具输出而非连接失败；缺失密钥是唯一真正的 HTTP 错误（连接失败 401）。参数不符合工具 schema 会在抓取前被拒绝，返回 MCP error -32602: Input validation error，不抓取也不计费。无匹配搜索返回成功结果但 jobs 数组为空，需在迭代前检查数组长度。已下架的职位返回 400，requestMetadata.status 为 error。
- apis 查询参数决定代理可见的工具；拼写错误会被忽略，全部错误则请求失败并列出未识别名称与所有有效值；省略参数则暴露全部 57 个 HasData 工具。
- 薪资仅在职位明确标出时存在，需防御性读取。
- 合规性：HasData 仅访问公开数据，但平台条款可能限制自动访问，用户需自行确保合规，涉及个人信息时需有 GDPR、CCPA 等法律依据。
- 仓库本身是远程服务器的配置与文档，无构建步骤。测试位于 test/ 目录，验证工具契约，CI 在每次推送和每周运行，该测试中的实时检查会消耗 10 积分。
许可
MIT 许可证，详见 LICENSE。
