mcpField
S
social-media-research

social-media-research

github.com/crawlora-org营销与增长142 次安装2 天前更新
代码仓库

关于 social-media-research

通过 Crawlora API 查询 11 个社交平台的公开资料、帖子、互动数据、关键词和趋势，适合社交媒体研究与品牌监测。结果以规范化 JSON 返回，并通过 shell helper 调用文档列出的接口。

主要功能

  1. 01查询公开账号资料与帖子
  2. 02检索关键词和话题标签
  3. 03查看帖子互动数据
  4. 04追踪平台热门趋势
  5. 05以规范化 JSON 返回结果

适用场景

  1. 01比较竞争对手的社交账号
  2. 02监测品牌提及与讨论
  3. 03评估网红账号的互动情况
  4. 04扫描跨平台热门话题

安装

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

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

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

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

详细介绍

社交媒体研究

查询公开个人资料、帖子和互动数据，运行关键词／话题标签搜索， 并追踪 11 个社交平台上的热门话题——所有数据均由 Crawlora API 返回为规范化 JSON，不抓取应用数据，也不使用非官方客户端库。

工具范围与数据流

此技能要求运行的唯一命令是可选的 shell 辅助脚本。它只会向文档列出且已加入许可名单的 Crawlora 路由发送 GET 请求。调用时，它会读取 CRAWLORA_API_KEY，并通过 HTTPS 将其作为 x-api-key 标头发送至 api.crawlora.net；不会将密钥发送给社交平台。它会在 TMPDIR 下短暂写入权限为 600 的 curl 配置文件，并在命令退出时将其删除。它不会检查其他环境变量、枚举文件、安装软件或以提升的权限运行。搜索词、公开用户名、URL 和其他请求目标会发送至 Crawlora；请勿提交机密调查内容或敏感个人数据。

Facebook Marketplace 路由返回的是公开商品信息，而非社交帖子。Reddit 潜在线索路由会根据公开帖子的产品／服务购买意向进行排名；仅在用户明确要求发现潜在客户时使用，并说明其帖子级评分方式，且不得推断敏感特征或将相关人员用于高影响决策。

何时使用此技能

  • “ 上 的个人资料／粉丝数／近期帖子是什么？”
  • “提取这条帖子的互动数据（点赞、评论、分享）。”
  • “在 上搜索关于 <topic/hashtag> 的帖子。” -“ 上现在有什么热门内容？”
  • 竞品社交媒体监听、网红研究或品牌提及监控。

设置（一次性）

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

工作方式

选择平台，然后选择任务：

  1. 个人资料 — /instagram/profile/{username}、/tiktok/profile/{handler}、 /threads/profile/{username}、/bluesky/profile、/x/profile/{username}、 /pinterest/user/{username}、/linkedin/company/{id}、 /facebook/{page}、/reddit/user/{username}/posts。
  2. 帖子／信息流 — /instagram/reels/{id}、/tiktok/posts、 /threads/profile/{username}/posts、/bluesky/author-feed、 /x/profile/{username}/posts、/pinterest/user/{username}/pins、 /reddit/subreddit/{subreddit}/posts。
  3. 单条帖子／图钉／图钉详情 — /instagram/post/{id}/{post_id}、 /tiktok/post/{id}、/threads/post/{username}/{code}（以及 /replies）、 /bluesky/post-thread、/x/post/{id}、/pinterest/pin/{id}、 /reddit/post/{id}（以及 /reddit/comments/{id}）。
  4. 搜索与发现 — /tiktok/search、/tiktok/search_hashtag、 /bluesky/search-actors、/pinterest/search、/reddit/search、 /facebook/marketplace/search（商品信息，而非社交帖子），以及参考文档中列出的 Bilibili 和 Patreon 公开发现接口。
  5. 热门内容 — /tiktok/trending、/tiktok/creative-center/hashtags、 /bluesky/trending-topics、/reddit/trends、/reddit/subreddits/posts （多个 subreddit 的热门信息流）。

完整接口列表、方法和参数：reference/endpoints.md。

调用 API

# Profile + posts:
scripts/crawlora.sh /tiktok/profile/nasa | jq '.'
scripts/crawlora.sh /reddit/user/spez/posts | jq '.'

# Search:
scripts/crawlora.sh /tiktok/search keyword="ai agents" | jq '.'
scripts/crawlora.sh /reddit/search q="web scraping" | jq '.'

# Trending:
scripts/crawlora.sh /tiktok/trending | jq '.'
scripts/crawlora.sh /bluesky/trending-topics | jq '.'

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

接口参考

请参阅 reference/endpoints.md，了解此技能使用的 Instagram、 TikTok、Threads、Bluesky、X、Pinterest、LinkedIn、Facebook、Reddit、Bilibili 和 Patreon 的全部接口。

示例

  • **竞品社交审计：**提取竞品活跃的各个平台上的个人资料和近期帖子，比较粉丝数和发帖频率。
  • **品牌提及扫描：**使用 /reddit/search、/tiktok/search 和 /pinterest/search 搜索同一品牌／产品名称，汇总提及量以及来自说明和评论的情绪线索。
  • **网红审核：**查看个人资料和近期帖子，核查粉丝数、互动率（每篇帖子的点赞数／评论数）和发帖稳定性，再决定是否合作。
  • **热门话题扫描：**使用 /tiktok/trending、/bluesky/trending-topics 和 /reddit/trends 获取当天的跨平台快照。

说明与限制

  • **额度／成功后付费：**仅在返回 2xx 时计费；免费套餐每月有 2,000 个额度。 可在 https://crawlora.net 获取密钥。
  • 仅限公开数据——公开个人资料／帖子；无需登录，也不提供私密内容。 请遵守各个平台的条款。
  • **安全性：**密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、放入查询参数或提交到代码库。
  • 各平台覆盖范围不同：与 TikTok 或 Reddit（完整搜索和热门内容）相比，X 和 Instagram 可获取的公开内容较少（个人资料和近期帖子）；在假设某个端点存在之前，请先查看 reference/endpoints.md。
  • 列表端点采用游标或分页方式；请使用返回的游标继续获取后续页面。

评论

支持 Markdown