Adzuna

@pipeworx/adzuna

Adzuna MCP — 全球招聘网站聚合平台（覆盖 16 个国家，约有 150 万个实时职位）。免费套餐：每月 250 次调用。

这是 Pipeworx 的一部分 — 一个将 AI Agent 连接到 1872+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供商无关联、未获其认可，也非由其发布。

工具

• search(country, what?, where?, distance?, results_per_page?, page?, salary_min?, salary_max?, full_time?, permanent?, sort?, max_days_old?)
• categories(country) — Adzuna 规范化的职位类别
• salary_histogram(country, what?, where?, location_filter?) — 薪资分布
• top_companies(country, what?, where?) — 发布符合筛选条件的职位最多的公司
• history(country, months?, location?, category?) — 职位数量／平均薪资历史时间序列
• regional_stats(country, location_filter?, category?) — 各地区当前职位数量

身份验证

Adzuna 使用两个查询参数：app_id 和 app_key。请前往 https://developer.adzuna.com/ 获取这两个参数。

• 平台密钥： 网关环境变量 PLATFORM_ADZUNA_KEY（格式为 <app_id>:<app_key>）
• 自带密钥： ?_apiKey=<app_id>:<app_key>

国家代码

gb（英国）、us、ca、de、fr、at、nl、pl、it、es、ru、br、in、mx、nz、au、sg、za。

数据源

https://api.adzuna.com/v1/api/jobs/<country>/...

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "adzuna": {
      "url": "https://gateway.pipeworx.io/adzuna/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/adzuna/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 通用元工具 — ask_pipeworx、 discover_tools、search_within、remember／recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于表中所列：目前，单个工具包端点会在该工具包自身的工具之外，列出约 30 个通用工具。连接的 initialize 响应会说明其确切范围，是当天适用范围的权威依据。

这是有意设计的，并非意外复用。这些元工具让范围受限的连接也能回答本工具包未涵盖的问题 — 通过 ask_pipeworx 跨整个目录进行路由 — 无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义带来的上下文成本高于路由的价值，请只连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/adzuna_search \
  -H 'Content-Type: application/json' \
  -d '{"country":"gb","what":"python developer","where":"London","results_per_page":25}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/adzuna_search。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账户，也无需经由网关：

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

也可以直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-adzuna

它通过 stdin/stdout 使用 MCP 协议，并仅针对此工具包的工具响应 initialize／tools/list／tools/call — 不包含上方网关连接额外提供的任何通用元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

与 ask_pipeworx 搭配使用

你可以不用直接调用工具，而是用日常语言提问 — 这既适用于上方的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Adzuna data" })

网关会选择合适的工具并自动填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT