indeeddata

indeeddata

indeeddata 是一个小型本地桥接程序，可连接托管的 HasData Indeed MCP 服务，并以 JSON 格式返回 Indeed 职位数据。它涵盖有关公开 职位的两个日常问题：现在某个地点有哪些职位符合 关键词，以及获取单个职位的 URL 后，该职位的实际 内容是什么。职位列表搜索会返回一页职位，包含标题、 公司、地点、薪资、发布日期、URL、赞助标记和稳定的 jobKey 标识符；职位详情获取会完整返回一条职位信息， 包括薪酬、雇佣类型、完整 描述和福利。

该桥接程序不保存任何职位信息。它会在本地提供上游 服务的工具列表，内容与从在线端点捕获的结果完全一致， 并将每次工具调用转发到上游，原样返回结果。 捕获的工具仅包含两个只读的公开职位获取操作：不支持 提交申请，不包含雇主或候选人的联系信息，也不包含 消息或支付工具。

工具

• hasdata_indeed_listing_getJobListings — 搜索 Indeed 职位。必填参数：keyword 和 location。 可选参数：sort（relevance / date）、domain （要搜索的国家站点，例如 au.indeed.com）、sponsoredOnly、datePosted （1 / 3 / 7 / 14 天）、remoteType （remote / hybrid）以及 start（分页结果偏移量）。 搜索美国远程职位时，请使用覆盖全国范围的地点，例如 United States：Indeed 会将完全远程的职位关联到国家， 而不是城市。
• hasdata_indeed_job_getJobDetails — 完整获取一条 职位信息。必填参数：url（职位的 viewjob URL，通常 取自职位列表搜索结果）。返回标题、公司、地点、 薪资／薪酬、雇佣类型、完整 描述和福利。

配置

• HASDATA_INDEED_MCP_URL（可选）— 覆盖 上游端点。默认为 https://mcp.hasdata.com/mcp?apis=indeed。（此 覆盖接口是本次重建中明确标注的自行实现。）
• HASDATA_API_KEY（可选）— 设置后，每个 上游请求都会携带 x-api-key: <key> 请求头，使用调用者自己的 HasData API 密钥。未 设置时，不会发送密钥请求头。（请求头名称和环境变量名称 由原始项目的注册记录确定；从此环境变量转发密钥是明确标注的 自行实现——捕获的原始工具接口未使用密钥。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26、 clientInfo 名称 indeeddata），然后发送 notifications/initialized 通知，最后发送携带调用者 原样参数的 tools/call 请求。上游通过 initialize 响应返回 Mcp-Session-Id 请求头后， 该值会随会话的每个后续请求发送；此会话会在进程 运行期间重复使用。响应可能是普通 JSON，也可能是 服务器发送事件；两种格式都会读取。

成功的上游结果会原样透传，包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态码、无法读取的响应 或无法完成的请求——会作为 isError 结果返回，其 文本以 indeeddata error: 开头（此错误呈现方式 是本次重建中明确标注的自行实现）。

CLI

每个工具也可作为子命令使用，接收一个 JSON 参数字符串：

npx @reneturcios/indeeddata hasdata_indeed_listing_getJobListings '{"keyword":"nurse","location":"Austin, Texas","sort":"date"}'
npx @reneturcios/indeeddata hasdata_indeed_job_getJobDetails '{"url":"https://www.indeed.com/viewjob?jk=example"}'
npx @reneturcios/indeeddata --version

退出代码：成功时为 0，返回 isError 结果时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/indeeddata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "indeeddata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/indeeddata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/indeeddata
docker run --rm ghcr.io/cloudcorprecords/indeeddata --version

容器的默认命令是 mcp，因此第一种形式会启动 stdio MCP 服务；其他参数则会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对桩接的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 参见 LICENSE。