pp-techmeme

Techmeme — Printing Press CLI

前提条件：安装 CLI

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

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

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

2. 验证：techmeme-pp-cli --version
3. 确保报告的安装目录已添加到将调用此技能的 Agent／运行时的 $PATH 中。

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

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

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

何时使用此 CLI

当你需要获取经过筛选、权威的科技新闻，又不想打开浏览器时，可使用 Techmeme CLI。适用于早间速览（since 8h）、主题监控（track add OpenAI）、来源分析（sources），以及需要用结构化数据回答“科技界现在有什么动态”的 AI Agent。

何时不使用此 CLI

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

独特功能

此 API 的其他工具均不具备这些功能。

时间洞察

• since — 查看过去 N 小时的所有科技头条；离开一段时间后快速了解动态的理想方式

  当 Agent 需要向用户介绍其开会期间科技界发生了什么时，这是唯一能回答这一问题的命令

  techmeme-pp-cli since 4h --agent
  

• digest — 获取按主题分组的每日科技新闻；相当于你有时间时会撰写的简报

  当 Agent 需要针对某个日期生成科技新闻简报时，此命令会将原始头条整理成易读的摘要

  techmeme-pp-cli digest --date 2026-05-08 --agent
  

持续监控

• track — 保存主题，并在它们登上 Techmeme 时获取提醒；无需打开浏览器标签页即可持续监控

  监控特定公司或技术的 Agent 可以订阅真正关心的内容，而不必轮询整个信息流

  techmeme-pp-cli track add 'OpenAI' && techmeme-pp-cli track check --agent
  

新闻洞察

• sources — 查看哪些出版物在 Techmeme 上占主导地位，并追踪来源出现频率随时间的变化

  分析媒体格局或决定优先关注哪些出版物时，此命令可提供有关来源影响力的可靠数据

  techmeme-pp-cli sources --top 20 --agent
  

• trending — 使用缓存数据进行频率分析，从近期头条中提取最热门的主题

  当 Agent 需要用数据而非感觉回答“科技界现在有什么热门话题”时

  techmeme-pp-cli trending --hours 24 --agent
  

• velocity — 找出热度飙升的报道，即多个来源在短时间内报道同一主题

  当 Agent 需要区分突发新闻和持续报道时，velocity 会显示当前正在升温的话题

  techmeme-pp-cli velocity --agent
  

• author — 在缓存档案中查找特定记者发布的所有 Techmeme 头条

  追踪特定记者的报道，或整理媒体联系人名单时，此命令可展示其在 Techmeme 上的报道记录

  techmeme-pp-cli author 'Kara Swisher' --agent
  

命令参考

feed-xml — 管理 feed xml

• techmeme-pp-cli feed-xml — Techmeme 当前排名前 15 的头条。RSS 2.0 格式。每个条目包含标题、链接（指向 Techmeme 永久链接）……

lb-opml — 管理 lb opml

• techmeme-pp-cli lb-opml — 列出 Techmeme 排名前 51 的来源的 OPML 文件，包含来源名称、网站 URL 和 RSS 订阅源 URL。定期更新……

river — 管理 river

• techmeme-pp-cli river — Techmeme 所有头条的滚动 5 天存档，按时间倒序排列。包含 150 条以上头条及时间戳……

techmeme-search — 管理 techmeme 搜索

• techmeme-pp-cli techmeme-search headlines — 搜索 Techmeme 头条。支持带引号的短语、通配符、+/-、AND/OR/NOT 和括号。可按 url 筛选……
• techmeme-pp-cli techmeme-search rss — 搜索结果的 RSS 订阅源。查询语法与 /search/query 相同。在任意 RSS 阅读器中订阅，即可接收特定内容的提醒……

查找合适的命令

知道自己想做什么，但不知道该用哪个命令时，可以直接询问 CLI：

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

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

使用示例

晨间简报

techmeme-pp-cli since 12h --agent --select title,source,time

只看标题、来源和时间戳，快速了解夜间科技新闻

跟踪公司动态

techmeme-pp-cli search 'Apple' --agent --select title,source,link

查找近期所有关于 Apple 的 Techmeme 头条

按时间范围搜索存档

techmeme-pp-cli search 'Apple' --days 30 --json

search 会查询 Techmeme 的实时存档（可追溯至约 2005 年）。每条 JSON 记录都包含 date 字段（ISO 格式的 YYYY-MM-DD；结果页面未显示可解析日期时为空字符串）。--days N 只保留最近 N 天内的结果（启用筛选时会丢弃没有日期的记录）。JSON 模式下没有匹配结果时，会在 stdout 输出空 JSON 数组 []，因此通过管道接收结果的程序始终能获得有效 JSON。

媒体格局

techmeme-pp-cli sources --top 20 --agent

查看 Techmeme 精选订阅源中占主导地位的 20 家出版物

突发新闻检测

techmeme-pp-cli velocity --agent

查找热度正在上升的报道——多个来源在短时间内报道

每日摘要

techmeme-pp-cli digest --agent

按主题整理今日科技新闻，方便快速阅读

身份验证设置

无需身份验证。

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

Agent 模式

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

• 支持管道 — JSON 输出到 stdout，错误输出到 stderr

• 支持筛选 — --select 保留部分字段。带点号的路径可深入嵌套结构；数组会逐元素遍历。对于输出冗长的 API，这对控制上下文大小至关重要：

  techmeme-pp-cli river --agent --select id,name,status
  

• 支持预览 — --dry-run 显示请求内容但不发送

• 适合离线使用 — 在本地 SQLite 存储可用时，同步/搜索命令可使用该存储

• 非交互式 — 不会发出提示，所有输入都通过标志传入

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

响应封装

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

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

解析 .results 获取数据，并查看 .meta.source 以确认数据来自实时来源还是本地存储。只有 stdout 连接到终端时，才会将人类可读的 N results (live) 摘要输出到 stderr；通过管道接收的程序或 Agent 会在 stdout 获得纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有问题时，请记录下来：

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

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

记录令你感到意外的地方，而不是提交错误报告。简短、具体、单行记录：日积月累，便能发挥作用。

输出交付

每个命令都接受 --deliver <sink>。除了 stdout（或替代 stdout）之外，输出还会发送到指定的目标，因此 Agent 可以路由命令结果，而无需手动通过管道传递。支持三种目标：

目标	效果
stdout	默认；仅写入 stdout
file:<path>	以原子方式将输出写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到 URL（使用 application/json；启用 --compact 时使用 application/x-ndjson）

遇到未知方案时会拒绝，并通过结构化错误指出支持的方案。Webhook 失败会返回非零状态，并在 stderr 中记录 URL + HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。如果定时运行的 Agent 每次都以相同配置调用同一命令，请使用它——这是 HeyGen 的“Beacon”模式。

techmeme-pp-cli profile save briefing --json
techmeme-pp-cli --profile briefing river
techmeme-pp-cli profile list --json
techmeme-pp-cli profile show briefing
techmeme-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，方便 Agent 在运行时发现它们。

退出代码

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

参数解析

解析 $ARGUMENTS：

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

MCP 服务安装

1. 安装 MCP 服务：

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

2. 注册到 Claude Code：

   claude mcp add techmeme-pp-mcp -- techmeme-pp-mcp
   

3. 验证：claude mcp list

直接使用

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

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

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