HikerAPI

hikerapi-mcp

HikerAPI 用の MCP サーバーです。Instagram データ API を提供します。npm で利用できます：hikerapi-mcp。

起動時に HikerAPI の OpenAPI 仕様から MCP ツールを生成します。HikerAPI が公開しているのは読み取り（GET）エンドポイントのみで、各ツールはそのうちの 1 つに 1 対 1 で対応しています（GET /v2/user/by/username → get_v2_user_by_username）。デフォルトでは、タスクごとに 1 つずつ、アシスタントがいつ使うべきかを説明する説明文付きの 中核ツール約 45 個が利用できます。HIKERAPI_TOOLS=all を設定すると、非推奨でないすべてのエンドポイント（100 個以上）を公開します。

API リクエストを 100 回無料で利用

**このリンクから登録**すると、HikerAPI のリクエストを 100 回無料で利用できます。クレジットカードは不要です。MCP サーバーを接続し、Claude／Cursor／Codex でプロンプトをいくつか試して、利用を決める前にデータ品質を評価するのに十分な回数です。

こちらから無料のリクエストを 100 回利用

クイックスタート

1. hikerapi.com/tokens で API キーを取得します。
2. AI アシスタントにサーバーを追加します。
3. アシスタントに次のような内容を尋ねます。
   • 「@nasa の Instagram プロフィールを取得して。」
   • 「ハッシュタグ #photography の最近の投稿から、上位 5 件を探して。」
   • 「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 と同じ形式です。アプリの MCP 設定ファイルで mcpServers の下にブロックを追加します。

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 仕様から起動時に生成されます。

HikerAPI には 100 個以上の GET エンドポイントがあり、その大部分は同じ呼び出しのバージョン違いです（v1／v2／gql／g2）。すべてをアシスタントに渡すと誤ったものを選んでしまうため、デフォルトの中核ツール群では、タスクごとに 1 つのエンドポイントに絞っています。

グループ	ツール数	例
プロフィール	16	get_v2_user_by_username, get_gql_user_medias, get_g2_user_followers
投稿、コメント、いいねしたユーザー	8	get_v2_media_info_by_url, get_v2_media_comments, get_v2_media_likers
検索	7	get_v2_fbsearch_accounts, get_v2_fbsearch_reels, get_v1_search_hashtags
ハッシュタグ	4	get_v2_hashtag_medias_top, get_v2_hashtag_medias_recent
場所	3	get_g2_location_by_id, get_v1_location_medias_recent_chunk
ストーリーズ、ハイライト、リンク	5	get_v2_story_by_url, get_v2_highlight_by_id, get_v1_share_by_url
音声	1	get_v2_track_by_id

中核ツールには、手作業で記述した説明（ツールの機能、関連ツールより優先すべき場合、ページネーション、課金について）があり、すべてのツールには読み取り専用の注釈が付いています。リストは src/curated.ts にあります。

HIKERAPI_TOOLS=all を設定すると、代わりに非推奨でないすべてのエンドポイントを公開します。以前と同じツール名を使うため、既存のプロンプトも引き続き動作します。ツール名はエンドポイントを反映しています（GET /v2/user/by/username → get_v2_user_by_username）。現在のリストとパラメーターのスキーマを確認するには、MCP 経由で tools/list を呼び出してください。どちらのモードでも、Legacy グループと System グループは除外されます。

設定

変数	説明	必須
HIKERAPI_KEY	HikerAPI アクセスキー（x-access-key ヘッダーとして送信されます）	yes
HIKERAPI_URL	ベース URL。デフォルト：https://api.hikerapi.com（別名：https://api.instagrapi.com）	no
HIKERAPI_SPEC_URL	OpenAPI 仕様の URL。デフォルト：${HIKERAPI_URL}/openapi.json	no
HIKERAPI_TOOLS	core（デフォルト）：厳選セット。タスクごとに 1 つのツール。all：非推奨ではないすべてのエンドポイント	no
HIKERAPI_TAGS	許可リスト：これらのタグを持つ操作のみを含めます（カンマ区切り）	no
HIKERAPI_EXCLUDE_TAGS	除外する追加タグ（デフォルトの Legacy、System に加えて指定）	no
HIKERAPI_TIMEOUT_MS	API 呼び出しごとのタイムアウト。デフォルト：30000	no
HIKERAPI_SPEC_TIMEOUT_MS	起動時の仕様取得のタイムアウト。デフォルト：60000	no
HIKERAPI_SPEC_RETRY_DELAY_MS	起動時の仕様取得 3 回の試行間の基本遅延。デフォルト：2000	no
HIKERAPI_MAX_RESPONSE_BYTES	各 API レスポンスから読み取る最大バイト数。デフォルト：10485760（10 MB）	no
HIKERAPI_MAX_SPEC_BYTES	OpenAPI 仕様から読み取る最大バイト数。デフォルト：8388608（8 MB）	no

Legacy タグと System タグはデフォルトで除外されます。非推奨の操作もスキップされます。

HIKERAPI_URL が api.hikerapi.com または api.instagrapi.com 以外のホストを指している場合、サーバーは起動時に警告を表示します。キーはそのホストに送信されるため、セルフホストまたはプロキシ経由の HikerAPI にのみ使用してください。

リクエストは User-Agent: hikerapi-mcp/<version> を付けて送信されます。

例 — よく使われるグループのすべてのエンドポイントを公開します。

"env": {
  "HIKERAPI_KEY": "...",
  "HIKERAPI_TOOLS": "all",
  "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
                             (core set by default)

ツールの引数は、エンドポイントの 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

テストを実行します（ユニットテストと、ローカルのモックサーバーに対する stdio スモークテスト。ネットワークや API キーは不要です）。

npm test

ライセンス

MIT