mcpField
A
apify-trend-analysis

apify-trend-analysis

github.com/apify营销与增长2.5k2.7k 次安装1 周前更新
代码仓库

关于 apify-trend-analysis

使用 Apify Actors 收集多平台数据，以发现和跟踪趋势的技能。它协助选择 Actor、运行分析，并在聊天中或以 CSV、JSON 查看结果。

主要功能

  1. 01按趋势类型选择 Actor
  2. 02通过 mcpc 获取 Actor 架构
  3. 03使用 Node.js 脚本运行 Actor
  4. 04在聊天中或以 CSV、JSON 输出
  5. 05汇总趋势发现

适用场景

  1. 01跟踪搜索和话题标签趋势
  2. 02查看社交平台热门内容
  3. 03导出趋势数据以便进一步分析

MCP 相关

通过 mcpc 调用 mcp.apify.com 获取 Actor 详情，包括输入架构和输出字段。

安装

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

$npx skills add https://github.com/apify/agent-skills --skill apify-trend-analysis

安装后在 Claude Code 中输入/apify-trend-analysis确认已加载。

附带文件reference/scripts/run_actor.js

详细介绍

趋势分析

使用 Apify Actors 从多个平台提取数据，发现并追踪新兴趋势。

前置条件

（无需提前检查）

  • 包含 APIFY_TOKEN 的 .env 文件
  • Node.js 20.6+（支持原生 --env-file）
  • mcpc CLI 工具：npm install -g @apify/mcpc

工作流

复制此清单并追踪进度：

Task Progress:
- [ ] Step 1: Identify trend type (select Actor)
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analysis script
- [ ] Step 5: Summarize findings
步骤 1：确定趋势类型

根据研究需求选择合适的 Actor：

用户需求Actor ID最适用于
搜索趋势apify/google-trends-scraperGoogle Trends 数据
追踪主题标签apify/instagram-hashtag-scraper主题标签内容
主题标签指标apify/instagram-hashtag-stats成效统计
视觉趋势apify/instagram-post-scraper帖子分析
发现热门内容apify/instagram-search-scraper搜索趋势
全面追踪apify/instagram-scraper完整数据
基于 API 的趋势apify/instagram-api-scraperAPI 访问
互动趋势apify/export-instagram-comments-posts评论追踪
产品趋势apify/facebook-marketplace-scraperMarketplace 数据
视觉分析apify/facebook-photos-scraper照片趋势
社群趋势apify/facebook-groups-scraper群组监测
YouTube Shortsstreamers/youtube-shorts-scraper短视频趋势
YouTube 主题标签streamers/youtube-video-scraper-by-hashtag主题标签视频
TikTok 主题标签clockworks/tiktok-hashtag-scraper主题标签内容
热门音频clockworks/tiktok-sound-scraper音频趋势
TikTok 广告clockworks/tiktok-ads-scraper广告趋势
发现页面clockworks/tiktok-discover-scraper发现趋势
探索趋势clockworks/tiktok-explore-scraper探索内容
热门内容clockworks/tiktok-trends-scraper病毒式传播内容
步骤 2：获取 Actor 架构

使用 mcpc 动态获取 Actor 的输入架构和详细信息：

export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content"

将 ACTOR_ID 替换为选定的 Actor（例如，apify/google-trends-scraper）。

返回内容包括：

  • Actor 描述和 README
  • 必填和可选输入参数
  • 输出字段（如有）
步骤 3：询问用户偏好

运行前，询问：

  1. 输出格式：
    • 快速回答 - 在聊天中显示前几条结果（不保存文件）
    • CSV - 导出包含所有字段的完整数据
    • JSON - 以 JSON 格式导出完整数据
  2. 结果数量：根据使用场景的特点确定
步骤 4：运行脚本

快速回答（在聊天中显示，不保存文件）：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.csv \
  --format csv

JSON：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.json \
  --format json
步骤 5：总结发现

完成后，报告：

  • 找到的结果数量
  • 文件位置和名称
  • 关键趋势洞察
  • 建议的后续步骤（深入分析、内容机会）

错误处理

APIFY_TOKEN not found - 请用户创建包含 APIFY_TOKEN=your_token 的 .env mcpc not found - 请用户安装 npm install -g @apify/mcpc Actor not found - 检查 Actor ID 拼写 Run FAILED - 请用户检查错误输出中的 Apify 控制台链接 Timeout - 减小输入规模或增大 --timeout

评论

支持 Markdown