pp-american-reindustrialization

美国再工业化 — Printing Press CLI

前提条件：安装 CLI

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

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

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

2. 验证：american-reindustrialization-pp-cli --version
3. 确保该安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

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

go install github.com/mvanhorn/printing-press-library/library/other/american-reindustrialization/cmd/american-reindustrialization-pp-cli@latest

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

何时使用此 CLI

当 Agent 或分析师需要对 americanreindustrialization.com 的公司目录和职位公告进行切片、联接或分析，且网站的筛选界面无法满足需求时，请使用此 CLI。本地 SQLite 存储支持组合跨资源筛选（查找具有属性 X 的公司所发布的职位）、汇总分析（行业 × 州热力图、融资 × 行业交叉表、薪资分布）以及时间差异对比（自上次同步以来的新内容）。如果 Agent 只需要每家公司约 30 个字段中的一部分，请将 --select 与 --json 搭配使用。

何时不使用此 CLI

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

独特功能

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

可累积的本地状态

• whats-new — 显示自指定日期以来新增或更新的公司和职位，让每周检查只需一个命令，无需逐条浏览列表。

  当分析师或 Agent 需要查看目录每周的变化时，请使用此功能；网站不提供此类视图。

  american-reindustrialization-pp-cli whats-new --since 2026-05-12 --json
  

跨实体本地查询

• openings find — 在单个查询中，按 work_mode、experience_level、最低薪资、州、公司规模、行业和发布时间筛选职位公告——这些条件组合无法通过网站界面实现。

  当用户想要精简后的候选列表，而不是浏览 25 页分页结果时，请使用此功能；跨资源筛选正是此 CLI 的核心价值。

  american-reindustrialization-pp-cli openings find --work-mode remote --experience senior --salary-min 150000 --state TX --json
  

• companies top-hiring — 按 jobs_count 降序排列公司，并可按行业、州或融资阶段筛选——网站没有排名视图。

  当求职者或招聘人员想知道“行业 X 中目前哪些公司的职位空缺最多”时，请使用此功能。

  american-reindustrialization-pp-cli companies top-hiring --sector robotics --limit 10 --json
  

• companies profile — 一次性获取单家公司的详细资料：完整字段、该公司的开放职位，以及类似公司（主要行业和员工人数范围相同）。

  当需要深入了解一家指定公司及其同类公司时，请使用此功能，适用于研究、尽职调查和竞争对手分析。

  american-reindustrialization-pp-cli companies profile harmony-ai --json
  

生态系统分析

• analytics sector-heatmap — 按主行业 × 总部所在州制作交叉表，统计公司数量（可选择按 jobs_count 加权，或按 funding_stage 筛选），揭示各行业的地理分布。

  回答“X 行业聚集在哪里”或“Y 行业中哪些州的招聘竞争最激烈”时，使用此工具。

  american-reindustrialization-pp-cli analytics sector-heatmap --funding-stage seed --weight jobs --json
  

• analytics funding-by-sector — 按融资阶段 × 主行业制作交叉表，统计公司数量和员工人数范围的中位数，揭示资本集中于何处。

  投资者需要了解再工业化目录中的资本分布时，使用此工具。

  american-reindustrialization-pp-cli analytics funding-by-sector --json
  

• analytics geo-clusters — 按经纬度将公司划分到网格单元（默认单元格为 50km），并输出各集群的中心点、成员数量、成员公司及主导行业。

  回答“X 行业中哪个都市区的集群最密集”这类问题时，使用此工具；该网站没有地图视图。

  american-reindustrialization-pp-cli analytics geo-clusters --state TX --radius-km 50 --json
  

• openings salary-stats — 计算筛选后职位的薪资中位数（p25 / p50 / p75），并单独报告薪资缺失的数量，确保数据缺失情况清晰可见。

  求职者或薪酬分析师需要薪酬范围而非单个职位信息时，使用此工具。

  american-reindustrialization-pp-cli openings salary-stats --sector robotics --experience senior --json
  

• companies cohorts — 按成立年份对公司分组（默认每 5 年一组），统计公司数量及每组排名前三的行业。

  撰写“再工业化浪潮中 2020 年以来成立的公司”相关内容，或跟踪生态系统随时间的变化时，可使用此工具。

  american-reindustrialization-pp-cli companies cohorts --bucket 5 --json
  

命令参考

categories — 顶级行业（通过 parent_id 构成层级结构）

• american-reindustrialization-pp-cli categories counts — category_id -> 公司数量的映射
• american-reindustrialization-pp-cli categories get — 按 slug 获取一个类别
• american-reindustrialization-pp-cli categories list — 列出所有类别（原始数组）
• american-reindustrialization-pp-cli categories search — 根据查询字符串搜索类别

companies — 推动再工业化的美国公司（制造业、机器人、先进材料、供应链）

• american-reindustrialization-pp-cli companies get — 按 slug 获取一家公司（直接返回完整对象，不作包装）
• american-reindustrialization-pp-cli companies list — 分页列出公司，并支持可选的服务端筛选
• american-reindustrialization-pp-cli companies search — 对公司名称和描述进行全文搜索；返回原始数组

news — 新闻源（上游当前为空；预留供未来 API 填充）

• american-reindustrialization-pp-cli news — 列出新闻条目（返回原始数组；采集时为空）

openings — 汇总目录中各公司发布的招聘职位

• american-reindustrialization-pp-cli openings categories — 列出至少有一个职位的类别，支持自动补全
• american-reindustrialization-pp-cli openings companies — 列出当前有未关闭职位的公司 {id, name}，支持自动补全
• american-reindustrialization-pp-cli openings get — 按 slug 获取一个招聘职位
• american-reindustrialization-pp-cli openings list — 分页列出招聘职位，并支持可选的服务端筛选（work_mode 和 experience_level 会生效；...
• american-reindustrialization-pp-cli openings tags — 列出至少出现在一个职位中的标签，支持自动补全
• american-reindustrialization-pp-cli openings titles — 列出与查询匹配的职位名称，支持自动补全

tags — 类型化标签（tag_type = tech、sector、focus area 等）

• american-reindustrialization-pp-cli tags counts — tag_id -> 公司数量的映射
• american-reindustrialization-pp-cli tags get — 按 slug 获取一个标签
• american-reindustrialization-pp-cli tags list — 列出所有标签（原始数组）
• american-reindustrialization-pp-cli tags search — 根据查询字符串搜索标签

查找合适的命令

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

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

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

示例

高薪资的资深远程机器人职位有哪些？

american-reindustrialization-pp-cli openings find --work-mode remote --experience senior --sector robotics --salary-min 150000 --json --select title,company.name,location_display,salary_min,salary_max,apply_url

组合筛选条件并精简字段——Agent 会收到精简的候选结果，而不是 25 条带完整内容的分页响应。

每周投资者扫描

american-reindustrialization-pp-cli whats-new --since 2026-05-12 --json --select kind,slug,name,primary_sector,funding_stage,hq_state

仅获取自上次同步以来的变更，并限定在交易流字段；一条命令即可取代周一早上逐条查看列表。

行业地理分布图

american-reindustrialization-pp-cli analytics geo-clusters --radius-km 75 --csv

按 75 公里网格对每家公司进行经纬度分桶，并将质心、成员和主要行业输出为 CSV，供下游制图使用。

目录中的资本分布图

american-reindustrialization-pp-cli analytics funding-by-sector --json

对 funding_stage × primary_sector 进行交叉制表，一次本地查询即可回答“资本正流向何处”。

身份验证设置

无需身份验证。

运行 american-reindustrialization-pp-cli doctor 以验证设置。

Agent 模式

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

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

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

  american-reindustrialization-pp-cli categories list --agent --select id,name,status
  

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

• 支持离线使用——有本地 SQLite 存储时，同步／搜索命令可以使用该存储

• 非交互式——不会发出提示，每项输入都是一个标志

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

响应封装

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

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

解析 .results 获取数据，并通过 .meta.source 判断数据来自实时接口还是本地存储。只有当 stdout 连接到终端，且未设置任何机器格式标志（--json、--csv、--compact、--quiet、--plain、--select）时，才会将人类可读的 N results (live) 摘要输出到 stderr——通过管道消费的程序／Agent 以及显式指定格式的运行都会在 stdout 上获得纯 JSON。

Agent 反馈

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

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

条目会保存在本地 ~/.american-reindustrialization-pp-cli/feedback.jsonl。除非设置了 AMERICAN_REINDUSTRIALIZATION_FEEDBACK_ENDPOINT，并且传入了 --send 或将 AMERICAN_REINDUSTRIALIZATION_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” 模式。

american-reindustrialization-pp-cli profile save briefing --json
american-reindustrialization-pp-cli --profile briefing categories list
american-reindustrialization-pp-cli profile list --json
american-reindustrialization-pp-cli profile show briefing
american-reindustrialization-pp-cli profile delete briefing --yes

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

退出代码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
5	API 错误（上游问题）
7	触发速率限制（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

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

MCP 服务安装

从此 CLI 发布的公共库条目或预构建版本安装 MCP 二进制文件，然后注册它：

claude mcp add american-reindustrialization-pp-mcp -- american-reindustrialization-pp-mcp

验证：claude mcp list

直接使用

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

   american-reindustrialization-pp-cli <command> [subcommand] [args] --agent
   

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