hikerapi-mcp

MCP-Server für HikerAPI — Instagram-Daten-API. Verfügbar auf npm: hikerapi-mcp.

Generiert beim Start automatisch MCP-Tools aus der HikerAPI-OpenAPI-Spezifikation, sodass jeder nicht als veraltet markierte GET-Endpunkt ohne manuell geschriebene Wrapper verfügbar ist. HikerAPI stellt nur Lese-Endpunkte (GET) bereit — der Server bildet jeden davon 1:1 auf ein MCP-Tool ab (GET /v2/user/by/username → get_v2_user_by_username).

Erhalten Sie 100 kostenlose API-Anfragen

Registrieren Sie sich über diesen Link und erhalten Sie 100 kostenlose HikerAPI-Anfragen — keine Kreditkarte erforderlich. Das reicht aus, um den MCP-Server einzurichten, ein paar Prompts in Claude/Cursor/Codex auszuprobieren und die Datenqualität zu bewerten, bevor Sie sich festlegen.

Holen Sie sich hier Ihre 100 kostenlosen Anfragen

Schnellstart

1. Holen Sie sich einen API-Schlüssel unter hikerapi.com/tokens.

2. Fügen Sie den Server Ihrem KI-Assistenten hinzu.

3. Fragen Sie Ihren Assistenten etwas wie:

   • "Rufe das Instagram-Profil für @nasa ab."

   • "Finde die 5 neuesten Beiträge unter dem Hashtag #photography."

   • "Zeige Stories für den Benutzer mit der ID 25025320."

Claude Code

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

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

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

Cursor / Windsurf

Gleiches Format wie bei Claude Desktop — fügen Sie den Block unter mcpServers in der MCP-Konfigurationsdatei der App ein.

Zed

Fügen Sie dies zu ~/.config/zed/settings.json hinzu:

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

OpenAI Codex

An ~/.codex/config.toml anhängen:

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

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

Tools

Die Tools werden beim Start aus der Live-HikerAPI OpenAPI-Spezifikation generiert, sodass die Liste immer der aktuellen API entspricht. Es gibt etwa 100+ Tools in diesen Gruppen (Stand zum Zeitpunkt dieses Schreibens):

Jeder Tool-Name spiegelt seinen Endpunkt wider (GET /v2/user/by/username → get_v2_user_by_username). Ihr Assistent kann tools/list über MCP aufrufen, um die vollständige, aktuelle Liste mit Parameterschemata zu erhalten. Legacy- und System-Gruppen sind standardmäßig ausgeschlossen.

Konfiguration

Legacy- und System-Tags sind standardmäßig ausgeschlossen. Veraltete Operationen werden ebenfalls übersprungen.

Wenn HIKERAPI_URL auf einen anderen Host als api.hikerapi.com oder api.instagrapi.com verweist, gibt der Server beim Start eine Warnung aus — Ihr Schlüssel wird dorthin gesendet, verwenden Sie ihn also nur für eine selbst gehostete oder über einen Proxy laufende HikerAPI.

Beispiel — nur die gängigsten Gruppen freigeben:

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

Funktionsweise

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

Tool-Argumente werden auf die query- und path-Parameter des Endpunkts abgebildet. Der Antworttext wird unverändert zurückgegeben (JSON-Text). Nicht-2xx-Antworten werden als Tool-Fehler mit dem HTTP-Status und dem Body angezeigt.

Entwicklung

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

Im Watch-Modus ausführen:

HIKERAPI_KEY=your-key npm run dev

Tests ausführen (Unit-Tests + stdio-Smoke-Tests gegen einen lokalen Mock-Server, kein Netzwerk/API-Schlüssel erforderlich):

npm test

Lizenz

MIT