HikerAPI

hikerapi-mcp

适用于 HikerAPI 的 MCP 服务——Instagram 数据 API。可在 npm 上获取：hikerapi-mcp。

启动时根据 HikerAPI OpenAPI 规范生成 MCP 工具。HikerAPI 仅提供读取（GET）端点——每个工具都与其中一个端点一一对应（GET /v2/user/by/username → get_v2_user_by_username）。默认情况下，你会获得约 45 个核心工具，每项任务一个工具，每个工具都附有说明，告知助手何时使用；设置 HIKERAPI_TOOLS=all 可启用所有未弃用端点（100 多个）。

获取 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 规范生成。

HikerAPI 有 100 多个 GET 端点，其中大多数是同一调用的不同版本（v1 / v2 / gql / g2）。将它们全部交给助手会导致助手选错，因此默认的核心工具集为每项任务保留一个端点：

分组	工具数	示例
个人资料	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 请求头发送）	是
HIKERAPI_URL	基础 URL。默认值：https://api.hikerapi.com（别名 https://api.instagrapi.com）	否
HIKERAPI_SPEC_URL	OpenAPI 规范 URL。默认值：${HIKERAPI_URL}/openapi.json	否
HIKERAPI_TOOLS	core（默认）：精选工具集，每项任务对应一个工具。all：所有未弃用的端点	否
HIKERAPI_TAGS	白名单：仅包含带有这些标签的操作（以逗号分隔）	否
HIKERAPI_EXCLUDE_TAGS	黑名单：要额外排除的标签（在默认排除的 Legacy、System 之外）	否
HIKERAPI_TIMEOUT_MS	API 调用的单次请求超时时间。默认值：30000	否
HIKERAPI_SPEC_TIMEOUT_MS	启动时获取规范的超时时间。默认值：60000	否
HIKERAPI_SPEC_RETRY_DELAY_MS	启动时获取规范的 3 次尝试之间的基础延迟。默认值：2000	否
HIKERAPI_MAX_RESPONSE_BYTES	每个 API 响应读取的最大字节数。默认值：10485760（10 MB）	否
HIKERAPI_MAX_SPEC_BYTES	OpenAPI 规范读取的最大字节数。默认值：8388608（8 MB）	否

默认排除 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