Herohunt Mcp

io.github.herohunt-ai由 GitHub 账号 herohunt-ai 发布v1.0.2更新于 Oct 24, 2026

People search API - find 1 billion candidates across LinkedIn and GitHub with real-time data.

概览

AI 生成的概览

HeroHunt 人才搜索 API 的 MCP 服务器,让助手在 LinkedIn、GitHub 和 StackOverflow 上查找候选人资料,并管理账户的 API 密钥与额度。

可以做什么
用自然语言查询搜索人才资料,并翻页获取更多结果,可选补充联系方式。查看账户套餐、额度和速率限制,并列出历史搜索。获取升级和账单门户链接。列出、创建、轮换和吊销 API 密钥。
适用场景
适合招聘或人才寻访场景,让助手在对话中直接执行人才搜索并汇总候选人资料。也便于在同一会话中查看搜索额度和管理 API 密钥。
运行要求
需要 HeroHunt API 密钥:本地 npm 包通过 HEROHUNT_API_KEY 环境变量提供,远程端点通过 Bearer Authorization 请求头提供。需要访问 HeroHunt API 的网络连接;可选 HEROHUNT_MCP_URL 变量可覆盖端点地址。
安装前请注意
API 密钥是敏感凭据,可访问账户及其额度。搜索会消耗额度(每个预留名额一个),补充联系方式可能产生额外费用。服务器可创建、轮换和吊销 API 密钥,会改变账户访问权限。候选人资料和联系方式数据会发送至 HeroHunt 服务器并从中返回。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Herohunt Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

herohunt-mcp

MCP server for the HeroHunt People Search API. Search for talent across LinkedIn, GitHub, and StackOverflow from any MCP-compatible AI agent.

Quick Start

Option 1: Remote URL (recommended)

Claude Desktop, Cursor, and most modern MCP clients support remote HTTP endpoints directly. No package installation needed.

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Cursor (~/.cursor/mcp.json):

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

Option 2: stdio (via npx)

For MCP clients that only support stdio transport:

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

Get Your API Key

Sign up at herohunt.ai/app/api/sign-up to get your API key.

Tools

ToolTypeDescription
people_searchWriteSearch for people profiles using natural language. 1 credit per reserved slot.
people_search_paginateReadFetch more results for an existing search. Free unless enrichment is on.
account_usage_getReadGet plan, credits, rate limit info. Free.
account_searches_listReadList past searches. Free.
account_upgrade_linkReadGet plan upgrade URL. Free.
account_billing_portal_linkReadGet Stripe billing portal URL. Free.
api_keys_listReadList API key prefixes and scopes. Free.
api_keys_createWriteCreate a new API key.
api_keys_rotateWriteRotate an existing API key.
api_keys_revokeWritePermanently revoke an API key.

Example

After connecting, ask your AI agent:

"Use HeroHunt to find me 5 senior Go engineers in Berlin and summarise the top 3."

The agent will call people_search with a natural language query, receive structured profile data (name, title, company, location, skills, platform links), and summarize the results.

To get contact info, ask:

"Enrich the results with emails and phone numbers."

The agent will call people_search_paginate with enrich: true.

Environment Variables

VariableRequiredDefaultDescription
HEROHUNT_API_KEYYes-Your People Search API key
HEROHUNT_MCP_URLNohttps://api.herohunt.ai/api/v1/mcpOverride the MCP endpoint URL

Links

License

MIT

来源:README.md,提交 6463135

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。