hikerapi-mcp

Servidor MCP para HikerAPI, la API de datos de Instagram. Disponible en npm: hikerapi-mcp.

Autogenera herramientas MCP a partir de la especificación OpenAPI de HikerAPI al iniciarse, por lo que cada endpoint GET no obsoleto se expone sin necesidad de envoltorios escritos a mano. HikerAPI solo expone endpoints de lectura (GET); el servidor asigna cada uno 1:1 a una herramienta MCP (GET /v2/user/by/username → get_v2_user_by_username).

Obtén 100 solicitudes de API gratuitas

Regístrate con este enlace y obtén 100 solicitudes gratuitas de HikerAPI; no se requiere tarjeta de crédito. Es suficiente para configurar el servidor MCP, probar algunos prompts en Claude/Cursor/Codex y evaluar la calidad de los datos antes de comprometerse.

Obtén tus 100 solicitudes gratuitas aquí

Inicio rápido

1. Obtén una clave de API en hikerapi.com/tokens.

2. Añade el servidor a tu asistente de IA.

3. Pregúntale a tu asistente algo como:

   • "Obtén el perfil de Instagram de @nasa."

   • "Encuentra las 5 publicaciones recientes principales bajo el hashtag #photography."

   • "Muestra las historias del usuario con id 25025320."

Claude Code

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

Claude Desktop

Añade a claude_desktop_config.json:

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

Cursor / Windsurf

La misma estructura que Claude Desktop: coloca el bloque bajo mcpServers en el archivo de configuración MCP de la aplicación.

Zed

Añade a ~/.config/zed/settings.json:

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

OpenAI Codex

Añade a ~/.codex/config.toml:

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

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

Herramientas

Las herramientas se generan al inicio a partir de la especificación OpenAPI de HikerAPI en vivo, por lo que la lista siempre coincide con la API actual. Aproximadamente más de 100 herramientas en estos grupos (tamaños al momento de escribir esto):

Cada nombre de herramienta refleja su endpoint (GET /v2/user/by/username → get_v2_user_by_username). Tu asistente puede llamar a tools/list a través de MCP para obtener la lista completa y actualizada con los esquemas de parámetros. Los grupos Legacy y System están excluidos por defecto.

Configuración

Las etiquetas Legacy y System están excluidas por defecto. Las operaciones obsoletas también se omiten.

Si HIKERAPI_URL apunta a un host distinto de api.hikerapi.com o api.instagrapi.com, el servidor imprimirá una advertencia al iniciarse; tu clave se enviará allí, así que úsala solo para una HikerAPI autohospedada o mediante proxy.

Ejemplo: exponer solo los grupos más comunes:

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

Cómo funciona

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

Los argumentos de la herramienta se asignan a los parámetros query y path del endpoint. El cuerpo de la respuesta se devuelve tal cual (texto JSON). Las respuestas que no sean 2xx se muestran como errores de herramienta con el estado HTTP y el cuerpo.

Desarrollo

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

Ejecutar en modo watch:

HIKERAPI_KEY=your-key npm run dev

Ejecutar pruebas (pruebas unitarias + pruebas de humo de stdio contra un servidor simulado local, no se requiere red/clave de API):

npm test

Licencia

MIT