English Français العربية

io.github.herohunt-ai/herohunt-mcp

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package herohunt-mcp
Claude Code 
claude mcp add herohunt-mcp -e 'HEROHUNT_API_KEY=<your herohunt_api_key>' -- npx -y herohunt-mcp@1.0.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "herohunt-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "herohunt-mcp@1.0.2"
            ],
            "env": {
                "HEROHUNT_API_KEY": "<your herohunt_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • HEROHUNT_API_KEY إلزامي سري HeroHunt API key. Get one at https://www.herohunt.ai/app/api/sign-up

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. herohunt-mcp
  2. Quick Start
  3. Get Your API Key
  4. Tools
  5. Example
  6. Environment Variables
  7. Links
  8. License

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

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):

{
  "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"
      }
    }
  }
}
Option 2: stdio (via npx)

For MCP clients that only support stdio transport:

{
  "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

License

MIT

الأسئلة الشائعة

ما هو io.github.herohunt-ai/herohunt-mcp؟

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

كيف أثبّت io.github.herohunt-ai/herohunt-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add herohunt-mcp -e 'HEROHUNT_API_KEY=<your herohunt_api_key>' -- npx -y herohunt-mcp@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.herohunt-ai/herohunt-mcp إلى مفتاح API؟

نعم. يتطلب HEROHUNT_API_KEY، وتضبطها في إعداداته.

هل io.github.herohunt-ai/herohunt-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.herohunt-ai/herohunt-mcp؟

ينشره herohunt-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.