hikerapi-mcp

MCP-сервер для HikerAPI — API данных Instagram. Доступен в npm: hikerapi-mcp.

Автоматически генерирует инструменты MCP из спецификации HikerAPI OpenAPI при запуске, поэтому каждый не устаревший эндпоинт GET доступен без написания оберток вручную. HikerAPI предоставляет только эндпоинты для чтения (GET) — сервер сопоставляет каждый из них 1:1 с инструментом MCP (GET /v2/user/by/username → get_v2_user_by_username).

Получите 100 бесплатных запросов к API

Зарегистрируйтесь по этой ссылке и получите 100 бесплатных запросов к HikerAPI — кредитная карта не требуется. Этого достаточно, чтобы подключить MCP-сервер, попробовать несколько промптов в Claude/Cursor/Codex и оценить качество данных перед покупкой.

Получите свои 100 бесплатных запросов здесь

Быстрый старт

1. Получите API-ключ на hikerapi.com/tokens.

2. Добавьте сервер в своего ИИ-ассистента.

3. Спросите ассистента о чем-то вроде:

   • "Получи профиль Instagram для @nasa."

   • "Найди 5 последних публикаций по хэштегу #photography."

   • "Покажи истории пользователя с 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 — поместите блок в раздел mcpServers в файле конфигурации MCP приложения.

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). Ваш ассистент может вызвать tools/list через MCP, чтобы получить полный актуальный список со схемами параметров. Группы 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

Запуск тестов (модульные + smoke-тесты stdio против локального mock-сервера, сеть/API-ключ не требуются):

npm test

Лицензия

MIT