herohunt-mcp은(는) 무엇을 하나요?
HeroHunt People Search API용 MCP 서버입니다. MCP 호환 AI 에이전트에서 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 에이전트에게 다음과 같이 요청하세요:
"HeroHunt를 사용하여 베를린에서 시니어 Go 엔지니어 5명을 찾고 그중 상위 3명을 요약해줘."
에이전트는 자연어 쿼리로 people_search를 호출하고, 구조화된 프로필 데이터(이름, 직함, 회사, 위치, 기술, 플랫폼 링크)를 받아 결과를 요약합니다.
연락처 정보를 얻으려면 다음과 같이 요청하세요:
"결과에 이메일과 전화번호를 추가해줘."
에이전트는 enrich: true 옵션과 함께 people_search_paginate를 호출합니다.
환경 변수
| 변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
HEROHUNT_API_KEY | 예 | - | People Search API 키 |
HEROHUNT_MCP_URL | 아니오 | https://api.herohunt.ai/api/v1/mcp | MCP 엔드포인트 URL 재정의 |
링크
라이선스
MIT