glassdata

glassdata

glassdata 是一个小型本地桥接程序，用于连接托管的 HasData Glassdoor MCP 服务，该服务以 JSON 格式返回 Glassdoor 职位数据。 它可以按关键词和地点搜索职位列表，也可以通过职位 URL 获取一条职位的完整信息：职位名称、公司及其评分、 职位所在地、薪资估算、发布日期、完整描述，以及列出的 资格要求和福利。

该桥接程序本身不保存任何职位列表。它会在本地返回 工具列表，内容与从实时端点捕获的内容完全一致，并将 每次工具调用转发到上游，原样返回收到的内容。捕获到的 接口仅包含两个针对公开职位的只读获取工具： 不支持提交申请、不包含雇主或求职者的联系数据，也没有 消息或支付工具。

工具

• hasdata_glassdoor_listing_getJobListings — 搜索 Glassdoor 职位列表。必需参数：keyword 和 location。可选参数：sort（recent / relevant）、 domain（要查询的国家/地区 Glassdoor 站点）、 datePosted（仅查询指定天数内发布的职位）、 radius（以英里为单位的搜索距离）、 minSalary 和 maxSalary（年薪范围）、 minRating（最低公司评分）、easyApplyOnly 和 remoteOnly 标记，以及用于 分页的 nextPageToken — 该令牌会携带原始搜索的 筛选条件。返回职位名称、公司、地点、薪资估算、 发布日期、职位 URL 和 jobId，以及每页的令牌。
• hasdata_glassdoor_job_getJobDetails — 获取一条职位的 完整信息。必需参数：url（职位 URL）。 返回职位名称、公司名称及评分、地点、薪资估算、 发布日期、完整描述，以及资格要求和福利。

配置

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

转发机制

首次调用工具时，客户端会在上游打开一个可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求 （protocolVersion 2025-03-26，clientInfo name glassdata），然后发送 notifications/initialized 通知，接着发送携带调用者原样参数的 tools/call 请求。当上游以 Mcp-Session-Id 标头响应 initialize 时，该值会附加到 此会话的所有后续请求中，并在进程运行期间复用该会话。 响应可能以普通 JSON 或服务器发送事件的形式到达；两者均可读取。

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

CLI

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

npx @reneturcios/glassdata hasdata_glassdoor_listing_getJobListings '{"keyword":"software engineer","location":"San Francisco, California"}'
npx @reneturcios/glassdata hasdata_glassdoor_job_getJobDetails '{"url":"https://www.glassdoor.com/job-listing/example"}'
npx @reneturcios/glassdata --version

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

MCP 服务

npx -y @reneturcios/glassdata mcp

MCP 客户端配置：

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

Docker

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

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

开发

npm install
npm run build
npm test
npm run dev

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

许可证

MIT — 参见 LICENSE。