HeroHunt.ai MCP (People Search API)

herohunt-mcp

适用于 HeroHunt People Search API 的 MCP 服务。从任何兼容 MCP 的 AI Agent 搜索 LinkedIn、GitHub 和 StackOverflow 上的人才。

快速开始

选项 1：远程 URL（推荐）

Claude Desktop、Cursor 和大多数现代 MCP 客户端都直接支持远程 HTTP 端点。无需安装软件包。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "herohunt-people-search": {
      "url": "https://api.herohunt.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "herohunt-people-search": {
      "url": "https://api.herohunt.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

选项 2：stdio（通过 npx）

适用于仅支持 stdio 传输的 MCP 客户端：

{
  "mcpServers": {
    "herohunt-people-search": {
      "command": "npx",
      "args": ["-y", "herohunt-mcp"],
      "env": {
        "HEROHUNT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

获取 API 密钥

在 herohunt.ai/app/api/sign-up 注册以获取 API 密钥。

工具

工具	类型	描述
people_search	写入	使用自然语言搜索个人资料。每个预留名额消耗 1 个额度。
people_search_paginate	读取	获取现有搜索的更多结果。除非启用了信息补充，否则免费。
account_usage_get	读取	获取套餐、额度和速率限制信息。免费。
account_searches_list	读取	列出以往的搜索。免费。
account_upgrade_link	读取	获取套餐升级 URL。免费。
account_billing_portal_link	读取	获取 Stripe 账单门户 URL。免费。
api_keys_list	读取	列出 API 密钥前缀和权限范围。免费。
api_keys_create	写入	创建新的 API 密钥。
api_keys_rotate	写入	轮换现有 API 密钥。
api_keys_revoke	写入	永久撤销 API 密钥。

示例

连接后，向你的 AI Agent 提问：

“使用 HeroHunt 帮我在柏林寻找 5 名资深 Go 工程师，并总结排名前 3 的结果。”

Agent 会使用自然语言查询调用 people_search，接收结构化个人资料数据（姓名、职位、公司、所在地、技能、平台链接），并总结结果。

要获取联系方式，请提问：

“为搜索结果补充电子邮箱和电话号码。”

Agent 会通过 enrich: true 调用 people_search_paginate。

环境变量

变量	必填	默认值	描述
HEROHUNT_API_KEY	是	-	你的 People Search API 密钥
HEROHUNT_MCP_URL	否	https://api.herohunt.ai/api/v1/mcp	覆盖 MCP 端点 URL

链接

• API 文档
• 注册
• 控制面板

许可证

MIT