hikerapi-mcp

HikerAPI — 인스타그램 데이터 API를 위한 MCP 서버입니다. npm에서 이용 가능합니다: hikerapi-mcp.

시작 시 HikerAPI OpenAPI 사양에서 MCP 도구를 자동으로 생성하므로, 더 이상 사용되지 않는(deprecated) 엔드포인트를 제외한 모든 GET 엔드포인트가 별도의 수동 래퍼 없이 노출됩니다. HikerAPI는 읽기(GET) 엔드포인트만 제공하며, 서버는 각 엔드포인트를 MCP 도구에 1:1로 매핑합니다 (GET /v2/user/by/username → get_v2_user_by_username).

100개의 무료 API 요청 받기

**이 링크로 가입**하시면 100개의 무료 HikerAPI 요청을 받으실 수 있습니다 — 신용카드가 필요 없습니다. MCP 서버를 연결하고, Claude/Cursor/Codex에서 몇 가지 프롬프트를 테스트하며, 데이터를 결정하기 전에 데이터 품질을 평가하기에 충분한 양입니다.

여기서 무료 100개 요청 받기

빠른 시작

1. hikerapi.com/tokens에서 API 키를 받으세요.

2. AI 어시스턴트에 서버를 추가하세요.

3. 어시스턴트에게 다음과 같이 질문해 보세요:

   • "@nasa의 인스타그램 프로필을 가져와 줘."

   • "해시태그 #photography의 최근 게시물 상위 5개를 찾아 줘."

   • "id가 25025320인 사용자의 스토리를 보여 줘."

Claude Code

claude mcp add hikerapi -e HIKERAPI_KEY=your-api-key -- npx -y hikerapi-mcp

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "hikerapi": {
      "command": "npx",
      "args": ["-y", "hikerapi-mcp"],
      "env": {
        "HIKERAPI_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf

Claude Desktop과 동일한 형식입니다 — 앱의 MCP 설정 파일 내 mcpServers 블록 아래에 넣으세요.

Zed

~/.config/zed/settings.json에 추가하세요:

{
  "context_servers": {
    "hikerapi": {
      "command": "npx",
      "args": ["-y", "hikerapi-mcp"],
      "env": {
        "HIKERAPI_KEY": "your-api-key"
      }
    }
  }
}

OpenAI Codex

~/.codex/config.toml에 추가하세요:

[mcp_servers.hikerapi]
command = "npx"
args = ["-y", "hikerapi-mcp"]

[mcp_servers.hikerapi.env]
HIKERAPI_KEY = "your-api-key"

도구

도구는 라이브 HikerAPI OpenAPI 사양에서 시작 시 생성되므로, 목록은 항상 현재 API와 일치합니다. 이 글을 작성하는 시점 기준으로 약 100개 이상의 도구가 다음 그룹으로 나뉩니다:

각 도구 이름은 해당 엔드포인트를 반영합니다 (GET /v2/user/by/username → get_v2_user_by_username). 어시스턴트는 MCP를 통해 tools/list를 호출하여 매개변수 스키마가 포함된 최신 전체 목록을 가져올 수 있습니다. Legacy 및 System 그룹은 기본적으로 제외됩니다.

설정

Legacy 및 System 태그는 기본적으로 제외됩니다. 더 이상 사용되지 않는 작업도 건너뜁니다.

HIKERAPI_URL이 api.hikerapi.com 또는 api.instagrapi.com 이외의 호스트를 가리키는 경우, 서버는 시작 시 경고를 출력합니다. 키가 해당 주소로 전송되므로, 직접 호스팅하거나 프록시된 HikerAPI에만 사용하십시오.

예시 — 가장 일반적인 그룹만 노출:

"env": {
  "HIKERAPI_KEY": "...",
  "HIKERAPI_TAGS": "User Profile,Post Details,Search,Hashtags,Stories"
}

작동 방식

AI Assistant ←stdio→ hikerapi-mcp ──https──> api.hikerapi.com
                          │
                          └─ fetches /openapi.json once on startup,
                             builds one MCP tool per GET endpoint

도구 인수는 엔드포인트의 query 및 path 매개변수에 매핑됩니다. 응답 본문은 그대로(JSON 텍스트) 반환됩니다. 2xx가 아닌 응답은 HTTP 상태 코드와 본문을 포함한 도구 오류로 표시됩니다.

개발

git clone https://github.com/subzeroid/hikerapi-mcp.git
cd hikerapi-mcp
npm install
npm run build
HIKERAPI_KEY=your-key node dist/index.js

감시 모드에서 실행:

HIKERAPI_KEY=your-key npm run dev

테스트 실행 (단위 테스트 + 로컬 모의 서버에 대한 stdio 스모크 테스트, 네트워크/API 키 불필요):

npm test

라이선스

MIT