mcpField
I
instagram-research

instagram-research

github.com/crawlora-org其他139 次安装2 天前更新
代码仓库

关于 instagram-research

通过 Crawlora API 将 Instagram 公开个人资料、Reels 和帖子数据整理为 JSON，适用于社交媒体研究，如达人评估和竞品审查。查询范围仅限公开内容。

主要功能

  1. 01查询公开个人资料
  2. 02获取分页 Reels 信息流
  3. 03查看单条帖子的详情
  4. 04Reels 和帖子查询使用数字 ID

适用场景

  1. 01查看达人的粉丝数和内容构成
  2. 02审查竞品资料及近期 Reels
  3. 03检查指定帖子的互动详情

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill instagram-research

安装后在 Claude Code 中输入/instagram-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

Instagram 调研

通过 Crawlora API 查询公开的 Instagram 个人资料、帖子和 Reels，全部以标准化 JSON 返回； 无需抓取应用数据或使用非官方客户端库。

适用场景

  • “ 的 Instagram 个人资料／粉丝数是多少？”
  • “获取这篇 Instagram 帖子的详细信息。”
  • “获取 最近发布的 Reels。”
  • 针对 Instagram 开展竞品社交媒体审查、网红筛选或品牌提及监测。

设置（仅需一次）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个积分，无需信用卡）。
  • 运行辅助程序前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助程序会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

  1. 个人资料 — /instagram/profile/{username} 返回指定 Instagram 用户名的公开个人资料详情。
  2. Reels — /instagram/reels/{id} 返回 Instagram 用户 ID 对应的 Reels 信息流，可通过可选的 max_id 游标进行分页。
  3. 帖子详情 — /instagram/post/{id}/{post_id} 根据 Instagram 用户 ID 和帖子 ID 返回指定帖子的媒体详情。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Profile:
scripts/crawlora.sh /instagram/profile/nasa | jq '.'

# Reels feed (paginate with max_id from the previous response):
scripts/crawlora.sh /instagram/reels/528817151 | jq '.'
scripts/crawlora.sh /instagram/reels/528817151 max_id=<cursor> | jq '.'

# Post detail (requires both the user ID and the post ID):
scripts/crawlora.sh /instagram/post/528817151/3123456789012345678 | jq '.'

所有请求均使用 scripts/crawlora.sh；它可以避免将 API 密钥暴露在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Instagram 端点。

示例

  • 网红筛选： 查看粉丝数、发帖频率和内容构成，为合作做准备。
  • 竞品社交媒体审查： 获取竞品的个人资料数据和近期 Reels，了解其粉丝增长和内容策略随时间的变化。
  • 帖子互动情况检查： 已知帖子 URL 时，提取用户 ID 和帖子 ID，然后调用 /instagram/post/{id}/{post_id} 获取该帖子的媒体详情。

注意事项与限制

  • 积分／成功后付费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个积分。请在 https://crawlora.net 获取密钥。
  • 仅限公开数据 — 仅支持公开个人资料和帖子；无需登录，无法访问私密内容。请遵守 Instagram 的条款。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中 — 切勿将其硬编码、作为查询参数传递或提交到代码库。
  • 查询 Reels 和帖子时需使用数字用户 ID，而非用户名 — /instagram/reels/{id} 和 /instagram/post/{id}/{post_id} 均使用 Instagram 内部数字用户 ID，而非 @username；如果只有用户名，请先从 /instagram/profile/{username} 的响应中获取 ID。
  • 公开功能有限 — 此技能仅支持个人资料查询、Reels 信息流和单个帖子详情；不支持 Instagram 关键词／话题标签搜索或热门内容端点。
  • Reels 分页通过 max_id 游标实现 — 使用响应中返回的游标继续获取后续页面。

评论

支持 Markdown