Instagram SuperPower
Инструменты
| Инструмент |
Назначение |
Стоимость |
| HikerAPI |
Аналитика: профили, рилсы, комменты, подписчики, хэштеги, поиск |
$0.001/запрос (Standard) |
| Cobalt |
Скачивание видео/фото с CDN Instagram |
Бесплатно (self-hosted) |
| Groq Whisper |
Транскрипция скачанных видео |
Бесплатно |
Документация и ссылки
Маппинг путей
Mac mini (координатор / агенты)
| Что |
Путь |
| Скрипт скачивания (Cobalt) |
~/.claude/skills/instagram-hikerapi/scripts/download.sh |
| Скрипт аналитики (HikerAPI) |
~/.claude/skills/instagram-hikerapi/scripts/analyze.sh |
| Скрипт watchlist |
~/.claude/skills/instagram-hikerapi/scripts/watchlist.sh |
| Скрипт деплоя куков |
~/.claude/skills/instagram-hikerapi/scripts/deploy-cookies.sh |
| Скрипт проверки куков |
~/.claude/skills/instagram-hikerapi/scripts/check-cookies.sh |
| HikerAPI ключ |
~/.secrets/hikerapi/api-key |
| Instagram креды (для Cobalt) |
~/.secrets/cobalt/accounts.json |
| Instagram куки (для Cobalt) |
~/.secrets/cobalt/cookies.json |
| Cobalt API ключ |
~/.secrets/cobalt/api-key |
| Watchlist |
~/.secrets/cobalt/watchlist.json |
| Скачанные файлы |
/tmp/downloads/ |
your server (YOUR_SERVER_IP, SSH: ssh $YOUR_SERVER_SSH)
| Что |
Путь |
| Cobalt Docker Compose |
/opt/cobalt/docker-compose.yml |
| Cobalt куки (рабочая копия) |
/opt/cobalt/cookies.json |
| Cobalt API ключи |
/opt/cobalt/keys/api-keys.json |
| Docker контейнер |
cobalt-api |
| Cobalt API endpoint |
http://127.0.0.1:9000/ (только localhost) |
Как всё связано
HikerAPI (облако) your server (YOUR_SERVER_IP)
───────────────── ────────────────────────────
api.hikerapi.com ◀── curl ── Mac mini / your server
аналитика, данные Cobalt API (localhost:9000)
$0.001/запрос скачивание медиа (бесплатно)
Mac mini
analyze.sh → HikerAPI (напрямую, без SSH)
download.sh → SSH → your server → Cobalt → Instagram CDN
watchlist.sh → analyze.sh + download.sh
HikerAPI -- Аутентификация
# ВАЖНО: используй api.instagrapi.com (без Cloudflare) вместо api.hikerapi.com
# api.hikerapi.com блокирует urllib/requests из скриптов
# Ключ хранится в:
cat ~/.secrets/hikerapi/api-key
# Использование в curl:
curl -s "https://api.instagrapi.com/ENDPOINT" \
-H "accept: application/json" \
-H "x-access-key: $(cat ~/.secrets/hikerapi/api-key)"
# Или как GET-параметр:
curl -s "https://api.instagrapi.com/ENDPOINT?access_key=$(cat ~/.secrets/hikerapi/api-key)"
Баланс: GET /sys/balance -- показывает оставшиеся запросы и сумму.
HikerAPI -- Основные эндпоинты
Пользователи
| Эндпоинт |
Описание |
Запросов |
GET /v2/user/by/username?username=X |
Профиль по username |
1 |
GET /v2/user/by/id?id=X |
Профиль по ID (быстрее) |
1 |
GET /v2/user/clips?user_id=X |
Рилсы пользователя (12 шт/страница) |
1 |
GET /gql/user/clips?user_id=X |
Рилсы через GraphQL |
1 |
GET /v1/user/medias/chunk?user_id=X |
Все посты (с пагинацией) |
1 |
GET /v2/user/stories?user_id=X |
Сторис |
1 |
GET /v2/user/followers?user_id=X |
Подписчики (с пагинацией) |
1 |
GET /v2/user/following?user_id=X |
Подписки |
1 |
GET /v1/user/highlights?user_id=X |
Хайлайты |
1 |
Медиа (посты/рилсы)
| Эндпоинт |
Описание |
Запросов |
GET /v2/media/info/by/code?code=X |
Инфо по коду поста |
1 |
GET /v2/media/info/by/url?url=X |
Инфо по URL |
1 |
GET /v2/media/comments?media_id=X |
Комментарии (15/стр) |
1 |
GET /v2/media/likers?media_id=X |
Кто лайкнул |
1 |
GET /v1/media/download/video?media_pk=X |
Скачать видео |
1 |
GET /v1/media/download/photo?media_pk=X |
Скачать фото |
1 |
Поиск
| Эндпоинт |
Описание |
Запросов |
GET /v2/fbsearch/topsearch?query=X |
Глобальный поиск |
1 |
GET /v2/fbsearch/reels?query=X |
Поиск рилсов |
1 |
GET /v2/fbsearch/accounts?query=X |
Поиск аккаунтов |
1 |
GET /v2/fbsearch/places?query=X |
Поиск мест |
1 |
Хэштеги
| Эндпоинт |
Описание |
Запросов |
GET /v2/hashtag/by/name?name=X |
Инфо о хэштеге |
1 |
GET /v2/hashtag/medias/top?hashtag_id=X |
Топ посты по хэштегу |
1 |
GET /v2/hashtag/medias/recent?hashtag_id=X |
Свежие посты по хэштегу |
1 |
Данные в ответах
Каждый media-объект содержит:
play_count / view_count -- просмотрыlike_count -- лайкиcomment_count -- комментарииtaken_at -- timestamp публикацииcode -- shortcode для URL (instagram.com/reel/{code}/)caption.text -- текст подписиuser.username -- автор
Быстрый старт
Профиль аккаунта
HIKER_KEY=$(cat ~/.secrets/hikerapi/api-key)
curl -s "https://api.instagrapi.com/v2/user/by/username?username=example_account" \
-H "x-access-key: $HIKER_KEY" | python3 -m json.tool
Рилсы аккаунта (топ залетевших)
HIKER_KEY=$(cat ~/.secrets/hikerapi/api-key)
# 1. Получить user_id
USER_ID=$(curl -s "https://api.instagrapi.com/v2/user/by/username?username=example_account" \
-H "x-access-key: $HIKER_KEY" | python3 -c "import json,sys; print(json.load(sys.stdin)['user']['pk'])")
# 2. Получить рилсы
curl -s "https://api.instagrapi.com/v2/user/clips?user_id=$USER_ID" \
-H "x-access-key: $HIKER_KEY" | python3 -c "
import json, sys
d = json.load(sys.stdin)
items = d.get('response',{}).get('items',[])
for item in sorted(items, key=lambda x: x['media'].get('play_count',0), reverse=True)[:5]:
m = item['media']
print(f'{m.get(\"play_count\",0):>10,} views | {m.get(\"like_count\",0):>6,} likes | https://instagram.com/reel/{m[\"code\"]}/')
"
Скачать рилс (через Cobalt)
bash ~/.claude/skills/instagram-hikerapi/scripts/download.sh "https://www.instagram.com/reel/REEL_CODE/"
Скачать + транскрибировать (нужен свой Whisper-скрипт, см. ниже)
WHISPER_SCRIPT=/path/to/your/whisper.sh \
bash ~/.claude/skills/instagram-hikerapi/scripts/download.sh "https://www.instagram.com/reel/REEL_CODE/" transcribe
Проверить баланс HikerAPI
curl -s "https://api.instagrapi.com/sys/balance" \
-H "x-access-key: $(cat ~/.secrets/hikerapi/api-key)"
# {"requests":N,"rate":8,"currency":"USD","amount":X.XX}
Типичные сценарии
1. «Покажи залетевшие рилсы конкурента»
bash scripts/analyze.sh <username> 5 14
Скрипт: HikerAPI → профиль → рилсы → сортировка по engagement → результат.
2. «Скачай этот рилс и расскажи о чём он»
bash scripts/download.sh "<url>" transcribe
Cobalt скачивает → Groq транскрибирует → агент анализирует.
3. «Добавь в мониторинг»
bash scripts/watchlist.sh add <username>
bash scripts/watchlist.sh scan 3 14
4. «Полный разбор конкурента»
analyze.sh <username> 5 14 → топ-5 рилсов + цифрыdownload.sh <url> transcribe для каждого из топ-3- Агент разбирает: хук → боль → решение → CTA
5. «Что вирусится по хэштегу»
HIKER_KEY=$(cat ~/.secrets/hikerapi/api-key)
# Получить hashtag_id
curl -s "https://api.instagrapi.com/v2/hashtag/by/name?name=aitools" -H "x-access-key: $HIKER_KEY"
# Топ-посты
curl -s "https://api.instagrapi.com/v2/hashtag/medias/top?hashtag_id=ID" -H "x-access-key: $HIKER_KEY"
Пагинация
Многие эндпоинты возвращают next_page_id. Для следующей страницы:
curl -s "https://api.instagrapi.com/v2/user/clips?user_id=123&page_id=NEXT_PAGE_ID" \
-H "x-access-key: $HIKER_KEY"
Рилсы: ~12 штук на страницу. Для 50 рилсов нужно ~4 запроса.
Rate Limits
HikerAPI
- Лимит: 8 запросов/секунду (тариф Standard)
- Без риска бана Instagram -- HikerAPI использует свой пул аккаунтов и прокси
- Баланс проверяется командой выше (
/sys/balance)
Cobalt (скачивание)
- Rate limits Instagram: 20 скачиваний/час на 1 аккаунт
- Пауза между запросами: минимум 3 секунды
- Пакетное скачивание (>5): пауза 10-15 секунд
- Строго последовательно, никогда параллельно
Оптимальная стратегия
- Аналитика (HikerAPI): без ограничений, до 8 req/sec
- Скачивание (Cobalt): 20/час, последовательно
- HikerAPI тоже умеет скачивать (
/v1/media/download/*), но тратит платные запросы -- используй Cobalt
Обслуживание
HikerAPI
# Баланс
curl -s "https://api.instagrapi.com/sys/balance" -H "x-access-key: $(cat ~/.secrets/hikerapi/api-key)"
# Ключ в дашборде: https://hikerapi.com → Tokens
Cobalt
# Статус
ssh $YOUR_SERVER_SSH "docker ps --filter name=cobalt-api --format '{{.Status}}'"
# Логи
ssh $YOUR_SERVER_SSH "docker logs cobalt-api --tail 20"
# Перезапуск
ssh $YOUR_SERVER_SSH "cd /opt/cobalt && docker compose restart cobalt-api"
Обновление куков Instagram (для Cobalt)
Подробный регламент: references/cookie-refresh.md
- Креды:
~/.secrets/cobalt/accounts.json
- Chromium CDP:
bash scripts/chromium-launch.sh start
- Логин через
Input.dispatchKeyEvent (посимвольно)
- Кнопка:
div[role="button"] (не <button type="submit">)
- 2FA: TOTP →
input[name="verificationCode"]
- Куки:
Network.getCookies → .instagram.com → cookies.json
- Деплой:
bash scripts/deploy-cookies.sh
Безопасность
- HikerAPI ключ:
~/.secrets/hikerapi/api-key (chmod 600)
- Cobalt: ТОЛЬКО
127.0.0.1:9000 на your server
- Доступ к your server: через Tailscale SSH
- Куки/креды: ТОЛЬКО
~/.secrets/cobalt/ (chmod 600)
- Запрещено: логировать ключи/куки, выводить в чат, коммитить в git
Требования для запуска
- HikerAPI ключ в
~/.secrets/hikerapi/api-key
- Для скачивания: self-hosted Cobalt + SSH-доступ + Cobalt API ключ (env
COBALT_SERVER=user@host)
- Для транскрипции (опционально): свой Whisper-скрипт (env
WHISPER_SCRIPT=/path/to/whisper.sh)
- Скилл в
~/.claude/skills/instagram-hikerapi/
qwwiwi