hikerapi-mcp

HikerAPI（InstagramデータAPI）用のMCPサーバーです。npmで利用可能です：hikerapi-mcp。

起動時にHikerAPIのOpenAPI仕様からMCPツールを自動生成するため、非推奨でないすべての 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. 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仕様 から生成されるため、リストは常に現在のAPIと一致します。執筆時点で、以下のグループ全体で約 100以上のツール があります：

各ツール名はエンドポイントを反映しています（GET /v2/user/by/username → get_v2_user_by_username）。アシスタントはMCP経由で tools/list を呼び出し、パラメータスキーマを含む最新の完全なリストを取得できます。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

テストを実行（ユニットテスト + ローカルモックサーバーに対するstdioスモークテスト、ネットワーク/APIキー不要）：

npm test

ライセンス

MIT