pp-trendhunter

Trend Hunter — Printing Press 命令行工具

前提条件：安装命令行工具

此技能使用 trendhunter-pp-cli 二进制文件。**调用此技能中的任何命令前，必须确认命令行工具已安装。**如果未安装，请先安装：

1. 使用 Printing Press 安装程序进行安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install trendhunter --cli-only
   

2. 确认安装：trendhunter-pp-cli --version
3. 确保所报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用 Go 直接安装（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/marketing/trendhunter/cmd/trendhunter-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿继续执行技能命令。

何时使用此命令行工具

当你想在 Agent 循环、脚本或日常例行任务中获取 TrendHunter 数据，而不是手动点击网站时，请使用此命令行工具。它尤其适用于逐周趋势监测、可供大模型引用的 FAQ 风格趋势摘要，以及整个语料库范围的关键词聚类。它是免费的免认证爬虫；如需使用官方付费 API，请改用 TrendHunter 的商业服务。

何时不应使用此命令行工具

对于需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或更改远程状态的请求，请勿启用此命令行工具。此命令行工具仅提供用于检查、导出、同步和分析的只读命令。

独特功能

其他任何适用于此 API 的工具都不具备这些功能。

可累积的本地状态

• digest — 生成某个类别的逐周摘要，展示新增趋势与重复趋势，以及排名靠前的上升关键词。

  每周进行竞争扫描的 Agent 可以询问“本周 eco 有哪些新趋势”，而无需手动逐个重新点击 30 张卡片。

  trendhunter-pp-cli digest --since 7d --category eco --json
  

• watch — 按类别提供仅含新增内容的信息流，弥补 TrendHunter 的 RSS 仅覆盖全局内容的不足。

  Agent 和独立研究者可以获取某个垂直领域的清晰增量，无需重新处理全局信息流。

  trendhunter-pp-cli watch --category gadgets --since 24h --json
  

• cluster — 通过 FTS5 共现分析及与前一时间窗口的变化量，呈现正在上升的关键词聚类。

  研究新兴主题的 Agent 可以看到哪些相关关键词正在加速增长，而不仅仅是热门趋势标题。

  trendhunter-pp-cli cluster --window 30d --min-count 3 --json
  

• authors — 按指定时间窗口内的发布频率对 TrendHunter 作者和未来学家进行排名，而非按终身发布总数排名。

  找出当前在你的领域活跃的趋势猎手，而不只是历史影响力最大的人。

  trendhunter-pp-cli authors --top 20 --since 30d --json
  

• inbox — 显示自上次调用 inbox 以来看到的趋势，使用按机器记录的游标表。

  将其加入周一早上的例行流程，就只会看到之前从未看过的内容。

  trendhunter-pp-cli inbox --json
  

原生支持 Agent 的信息提取

• faq — 从趋势页面提取 FAQPage JSON-LD，并转换为结构化问答。

  Agent 可以直接获得每个趋势的问答摘要，随时引用，无需再提示其他大模型总结文章。

  trendhunter-pp-cli faq ai-clone --json
  

• brief — 一次性生成 Agent 简报：某个类别中排名靠前的 N 个趋势，每个趋势都包含 FAQ 问答和关键词，并以 JSON 或 Markdown 格式呈现。

  可直接接入 Agent 提示词，为市场备忘录提供可靠依据，无需编写胶水代码。

  trendhunter-pp-cli brief --category ai --top 10 --format markdown
  

• scout — 获取某个类别中的热门趋势，根据其与业务资料的相关性逐一评分，并可选择通过本地大模型进行评分。

  研究某个垂直领域的 Agent 可以获得按排名排列、限定业务范围的趋势列表，并直接传递到工作流的下一阶段。

  trendhunter-pp-cli scout --category kitchen --business "We sell smart ovens for home cooks" --top 10 --llm
  

图谱与综合分析

• megatrend-map — 从起始 slug 出发，沿相关趋势图谱向下遍历两层，返回第 1 层和第 2 层的相关 slug，帮助你查看围绕某个概念聚集的免费趋势。

  评估是否值得花 $295 购买付费巨趋势报告的人，可以查看哪些免费趋势与之相关。

  trendhunter-pp-cli megatrend-map ai-clone --json
  

发现信号

此 CLI 根据浏览器观察到的流量上下文生成。

• 捕获覆盖范围：共 30 条网络记录中的 11 个 API 条目
• 协议：html（置信度 100%）、rss（置信度 100%）
• 生成提示：使用标准库 HTTP 传输（http_transport: standard）。默认 UA 必须模拟 Chrome——curl 的默认 UA 会被拦截。默认 Accept 标头必须采用 Chrome 风格的 'text/html,application/xhtml+xml,application/xml;q=0.9,/;q=0.8'——单独使用 '/' 会被拦截。RSS feed 仅限全站。按类别获取的 RSS 会返回有效但为空的频道；请勿调用。趋势页面偶尔会重定向到垂直领域的微型网站（cleanthesky.com 等）。请跟随重定向，并记录规范的 /trends/ URL。/trends/ 上的 FAQPage JSON-LD 是信息密度最高的 Agent 摘要来源；请使用 faq 命令提取。无需 clearance cookie、Surf 或浏览器 sidecar。

命令参考

category — 类别索引页（tech、fashion、food、eco、ai、marketing、design 等）

• trendhunter-pp-cli category <category> — 获取 TrendHunter 类别索引页（约 30 个趋势卡片）。CLI 的 'category ' 命令会解析此页面。

megatrends — 巨趋势／模式索引页。

• trendhunter-pp-cli megatrends — 获取巨趋势索引页。

popular — 精选的“当前热门”索引。

• trendhunter-pp-cli popular — 获取热门趋势索引页（约 30 个卡片）。运行 'popular' 获取解析后的 JSON。

reports — 趋势报告索引。

• trendhunter-pp-cli reports — 获取趋势报告落地页（标题、描述、付费 PDF 链接）。

results — 站内搜索结果端点（框架已提供手工编写的 search 命令；此端点会公开原始 HTML 页面）。

• trendhunter-pp-cli results — 执行 TrendHunter 搜索并获取结果页 HTML。CLI 的 'search ' 会解析此页面；传入 --raw 可获取 HTML。

rss — 全站 RSS feed，包含全站最新的 30 条趋势。

• trendhunter-pp-cli rss — 获取全局 RSS 2.0 feed（约 30 条最新趋势）。使用 'sync' 将这些内容存入本地存储；此原始端点是……

scoreboard — 顶级贡献者和趋势排行榜。

• trendhunter-pp-cli scoreboard — 获取排行榜页面，其中包含顶级贡献者账号名和近期趋势。运行 'scoreboard' 获取解析后的 JSON。

sitemap — 主站点地图，包含 430 多个 URL（类别、未来学家、贡献者、中心页）。

• trendhunter-pp-cli sitemap — 获取 sitemap.xml。CLI 的 'catalog refresh' 会使用此功能；用户应改用该命令。

trends — 单个趋势页面，包含完整元数据、FAQ 问答、相关趋势、作者和类别。

• trendhunter-pp-cli trends <slug> — 获取指定 slug 的完整趋势页面 HTML。CLI 的 'trend show ' 会解析此页面；用户应改用该命令……

手工编写的命令

• trendhunter-pp-cli sync — 将全局 RSS Feed（及可选类别）同步到本地 SQLite 存储。每晚运行；可幂等执行。
• trendhunter-pp-cli search <query> — 全文搜索。优先使用本地数据（在已同步趋势上运行 FTS5），添加 --live 可将请求分发到上游搜索端点，并...
• trendhunter-pp-cli trend — 趋势详情命令。'trend show ' 会解析页面；'trend faq ' 会提取 FAQPage JSON-LD；'trend...
• trendhunter-pp-cli category <name> — 浏览类别。以 JSON 或表格形式返回最近约 30 个趋势卡片。--sync 会重新获取并写入...
• trendhunter-pp-cli popular — 显示“当前热门”趋势（从 /popular 解析）。
• trendhunter-pp-cli scoreboard — 显示贡献者和趋势排行榜。使用 --top 仅显示排名靠前的贡献者。
• trendhunter-pp-cli pull — 将全局 RSS Feed 和站点地图同步到本地已解析趋势存储。可幂等执行。
• trendhunter-pp-cli digest — 汇总新趋势与重复趋势的周环比变化，并列出增幅最大的关键词。可选参数 --category、--since（默认 7d）。
• trendhunter-pp-cli watch --category <name> — 按类别获取仅包含新增内容的 Feed，弥补 /rss 仅提供全局 Feed 的不足。
• trendhunter-pp-cli faq <slug> — 从 /trends/ 页面提取 FAQPage JSON-LD 问答。
• trendhunter-pp-cli cluster — 通过 FTS5 共现分析发现上升中的关键词簇，并与上一时间窗口进行比较。
• trendhunter-pp-cli authors — 按时间窗口统计作者活跃度（与该站点仅提供终身数据的 /scoreboard 不同）。
• trendhunter-pp-cli megatrend-map <slug> — 遍历相关趋势图，深度为 2；展示所属的巨趋势类别。
• trendhunter-pp-cli brief --category <name> — 一次性生成 Agent 简报：包含排名前 N 的趋势及 FAQ 问答，以 JSON 或 Markdown 格式输出。
• trendhunter-pp-cli inbox — 按机器记录游标，获取自上次调用 inbox 后新增的趋势。
• trendhunter-pp-cli doctor — 检查可访问性和数据库健康状况：探测 /rss、/sitemap.xml 和存储，并显示绿/黄/红状态横幅。
• trendhunter-pp-cli scout --category <name> --business <description> — 业务相关性侦察。获取某个类别中的热门趋势，并根据与业务档案的相关性为每项趋势评分（关键词...

查找合适的命令

当你知道要做什么，却不知道该用哪个命令时，可以直接询问 CLI：

trendhunter-pp-cli which "<capability in your own words>"

which 会根据自然语言能力查询，从此 CLI 精选的功能索引中匹配最合适的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有足够可信的匹配结果——请改用 --help，或缩小查询范围。

用法示例

每周 eco 趋势备忘录

trendhunter-pp-cli digest --since 7d --category eco --json --select trends.title,trends.keywords,trends.first_seen

仅返回过去一周每个新增 eco 趋势的标题、关键词和首次出现时间戳。内容精简，非常适合发布到 Slack 或作为大模型提示词。

AI Agent 简报

trendhunter-pp-cli brief --category ai --top 10 --format markdown

列出排名前 10 的 AI 趋势，每项都包含 FAQ 问答和关键词，并以 Markdown 格式呈现，可直接粘贴到提示词中。

上升关键词扫描

trendhunter-pp-cli cluster --window 30d --min-count 3 --json

找出共现次数较上一 30 天时间窗口有所上升的关键词。

本月活跃的未来学家

trendhunter-pp-cli authors --top 20 --since 30d --json

按时间窗口统计趋势猎手和未来学家的发布活跃度——该站点的 /scoreboard 仅提供终身数据。

将巨趋势映射到免费趋势

trendhunter-pp-cli megatrend-map ai-clone --json

从起始 slug 开始，向下遍历两层相关趋势图，展示该概念周围深度为 1 和深度为 2 的相关 slug。

身份验证设置

无需身份验证。

运行 trendhunter-pp-cli doctor 验证设置。

Agent 模式

在任何命令中添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可管道传输——JSON 输出到 stdout，错误输出到 stderr

• 可筛选——--select 保留部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。在响应冗长的 API 中，这对于缩小上下文至关重要：

  trendhunter-pp-cli category mock-value --agent --select id,name,status
  

• 可预览——--dry-run 显示请求，但不会发送

• 便于离线使用——如果本地 SQLite 存储可用，同步／搜索命令可以使用该存储

• 非交互式——绝不显示提示，所有输入均通过标志传入

• 只读——请勿使用此 CLI 执行创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他会更改数据的请求

响应封装

从本地存储或 API 读取数据的命令，会将输出封装在来源信息中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

通过 .results 解析数据，通过 .meta.source 判断数据来自实时 API 还是本地存储。只有当 stdout 连接到终端时，才会将人类可读的 N results (live) 摘要输出到 stderr；通过管道传输的进程和 Agent 消费者则只会在 stdout 上收到纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有不妥之处时，请记录下来：

trendhunter-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
trendhunter-pp-cli feedback --stdin < notes.txt
trendhunter-pp-cli feedback list --json --limit 10

条目会保存在本地的 ~/.trendhunter-pp-cli/feedback.jsonl 中。只有在设置了 TRENDHUNTER_FEEDBACK_ENDPOINT，并且传入了 --send 或 TRENDHUNTER_FEEDBACK_AUTO_SEND=true 时，条目才会通过 POST 发送。默认情况下，反馈只保存在本地。

请记录让你感到意外的事，而不是提交错误报告。简短、具体、单行记录：这才是能不断积累价值的部分。

输出传递

每个命令都接受 --deliver <sink>。输出会传递到指定目标，同时也会输出到 stdout，或取代 stdout 输出，因此 Agent 无需手动通过管道传递命令结果。支持以下三种目标：

目标	效果
stdout	默认值；仅输出到 stdout
file:<path>	将输出原子性地写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（当使用 --compact 时，内容类型为 application/json 或 application/x-ndjson）

遇到未知方案时会拒绝处理，并返回包含受支持方案的结构化错误。Webhook 请求失败时会返回非零状态码，并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置文件是保存的一组标志值，可在多次调用中重复使用。如果计划任务中的 Agent 每次运行都以相同配置调用同一命令，可使用配置文件——这就是 HeyGen 的“Beacon”模式。

trendhunter-pp-cli profile save briefing --json
trendhunter-pp-cli --profile briefing category mock-value
trendhunter-pp-cli profile list --json
trendhunter-pp-cli profile show briefing
trendhunter-pp-cli profile delete briefing --yes

显式传入的标志始终优先于配置文件中的值；配置文件中的值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置文件，供 Agent 在运行时发现。

退出码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
5	API 错误（上游问题）
7	请求过多（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 trendhunter-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（以 --agent 执行 CLI 命令）

安装 MCP 服务

1. 安装 MCP 服务：

   go install github.com/mvanhorn/printing-press-library/library/marketing/trendhunter/cmd/trendhunter-pp-mcp@latest
   

2. 在 Claude Code 中注册：

   claude mcp add trendhunter-pp-mcp -- trendhunter-pp-mcp
   

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which trendhunter-pp-cli 如果未找到，请提供安装选项（参见本技能顶部的先决条件）。
2. 根据用户的查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 添加 --agent 标志执行：

   trendhunter-pp-cli <command> [subcommand] [args] --agent
   

4. 如果命令存在歧义，请查看子命令帮助：trendhunter-pp-cli <command> --help。