# HikerAPI

MCP-сервер, который даёт ассистенту доступ к данным Instagram через HikerAPI: профили, посты, рилсы, сторис, комментарии, хэштеги и геометки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Автор: subzeroid
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/subzeroid/hikerapi-mcp
- Обновлён: 2026-10-06
- HTML: https://affpapa.org/nevibecode/mcp/hikerapi

## Что делает

Сервер поднимается локально по stdio и на старте собирает MCP-инструменты из OpenAPI-спеки HikerAPI. Все эндпоинты HikerAPI — только чтение, и каждый инструмент соответствует одному вызову: `GET /v2/user/by/username` превращается в `get_v2_user_by_username`. По умолчанию доступен набор примерно из 45 инструментов, по одному на задачу, с описаниями, когда какой брать. Переменная `HIKERAPI_TOOLS=all` открывает все неустаревшие эндпоинты, больше сотни.

Ключ HikerAPI обязателен: он уходит в заголовке `x-access-key`. Без `HIKERAPI_KEY` сервер не заработает. Если `HIKERAPI_URL` указывает не на `api.hikerapi.com` или `api.instagrapi.com`, при запуске появится предупреждение — ключ будет отправлен на этот хост, так что указывайте свой адрес только для самостоятельно размещённого или проксированного HikerAPI.

Настраивается через переменные окружения: `HIKERAPI_TOOLS` (`core` по умолчанию или `all`), `HIKERAPI_TAGS` и `HIKERAPI_EXCLUDE_TAGS` для фильтра по тегам, таймауты запросов и загрузки спеки, лимиты размера ответа и спеки. Теги `Legacy` и `System` исключены в обоих режимах, устаревшие операции пропускаются.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `HIKERAPI_KEY`, `HIKERAPI_TOOLS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env HIKERAPI_KEY=<HIKERAPI_KEY> --env HIKERAPI_TOOLS=<HIKERAPI_TOOLS> --transport stdio hikerapi -- npx -y hikerapi-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add hikerapi --env HIKERAPI_KEY=<HIKERAPI_KEY> --env HIKERAPI_TOOLS=<HIKERAPI_TOOLS> -- npx -y hikerapi-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hikerapi": {
            "command": "npx",
            "args": [
                "-y",
                "hikerapi-mcp"
            ],
            "env": {
                "HIKERAPI_KEY": "<HIKERAPI_KEY>",
                "HIKERAPI_TOOLS": "<HIKERAPI_TOOLS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hikerapi": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "hikerapi-mcp"
            ],
            "env": {
                "HIKERAPI_KEY": "<HIKERAPI_KEY>",
                "HIKERAPI_TOOLS": "<HIKERAPI_TOOLS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e HIKERAPI_KEY=<HIKERAPI_KEY> -e HIKERAPI_TOOLS=<HIKERAPI_TOOLS> hikerapi npx -y hikerapi-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- посмотреть профиль Instagram по нику
- собрать свежие посты по хэштегу
- выгрузить комментарии к посту
- найти аккаунты через поиск
- получить сторис пользователя по id

## Примеры запросов агенту
- Покажи профиль Instagram для @nasa
- Найди пять последних постов с хэштегом `#photography`
- Выведи сторис пользователя с id 25025320

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [apify-mcp-server](https://affpapa.org/nevibecode/mcp/apify-mcp-server.md) — MCP-сервер · ★ 12927

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
