pp-company-goat

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Company GOAT — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the

company-goat-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install company-goat --cli-only

Verify:
```
company-goat-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/company-goat/cmd/company-goat-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

本工具驱动

company-goat-pp-cli

二进制文件。在调用本工具的任何命令前，必须先验证CLI已安装。若未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install company-goat --cli-only

验证：
```
company-goat-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

若

npx

安装失败（无Node环境、离线等情况），可退而采用直接Go安装方式（要求Go 1.23+版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/company-goat/cmd/company-goat-pp-cli@latest

若安装后执行

--version

提示“command not found”，说明安装步骤未将二进制文件添加到

$PATH

中。在验证成功前，请不要执行本工具的命令。

When to Use This CLI

何时使用本CLI

Use Company GOAT when an agent or human needs structured company-research data on a small or midsize startup — fundraising, engineering signal, mention timeline, legal entity, domain age — without paying for Crunchbase Pro. Best for one-company-at-a-time deep research. Not for bulk discovery (sources don't scale to thousands of queries) and not for global private-market funding-graph queries (no source has that for free).

当Agent或用户需要获取中小型初创公司的结构化调研数据（融资情况、技术信号、提及时间线、法律实体、域名年限），且不想付费购买Crunchbase Pro时，可使用Company GOAT。它最适合单公司深度调研，不适合批量查询（数据源无法支持数千次查询），也不适合全球私募市场融资图谱查询（没有免费数据源提供此类信息）。

The killer feature: SEC Form D, free

核心亮点：免费获取SEC Form D数据

Most US startups raising priced equity rounds (Series Seed → Series C, Reg D 506(b)/506(c)) file Form D with the SEC within 15 days of first sale. The filing names the issuer, the offering amount, the exemption claimed, and the related persons (officers, directors, promoters). Crunchbase Pro charges $999/year for a wrapper around this same source; this CLI extracts it directly from EDGAR for free. Reach for

funding

when an agent needs to verify a US startup's actual fundraising history rather than quote Crunchbase Free's empty "undisclosed" rows.

大多数进行定价股权融资轮次（种子轮→C轮，Reg D 506(b)/506(c)）的美国初创公司，会在首次发售的15天内向SEC提交Form D文件。该文件会列出发行人、融资额、申请的豁免条款及相关人员（高管、董事、发起人）。Crunchbase Pro每年收费999美元提供该数据源的包装服务；而本CLI可直接从EDGAR免费提取该数据。当Agent需要验证美国初创公司的实际融资历史，而非引用Crunchbase免费版中显示“未披露”的空行时，请使用

funding

命令。

Coverage at a glance

覆盖范围概览

SEC Form D /
funding
/
funding-trend
— US-only. Reg D priced rounds. Pre-Series-A SAFEs are not covered. Empty filings + a
```
coverage_note
```
is the expected response for non-US companies, pre-priced-round companies, and companies that just haven't filed yet. When Form D is empty,
```
funding
```
falls back to a broader EDGAR full-text search and surfaces mentions binned by signal class: subsidiary (10-K parent mentions), debt (Venture Lending and Leasing portfolio mentions), acquisition (8-K parent disclosures), and other.
```
funding --who
```
also searches across all form types, not just Form D. Disambiguation: EDGAR's full-text search matches by name fragment, so "Notion" hits both Notion Labs and Notion Capital VC. The result includes
```
cik_summaries
```
and
```
is_ambiguous: true
```
whenever multiple distinct CIKs match. Re-call with
```
--cik <id>
```
(CIK from the summary) to filter to the correct entity. The compound commands (
```
snapshot
```
,
```
compare
```
,
```
signal
```
) propagate the ambiguity flag through their output and refuse to synthesize a side-by-side number when ambiguous — the agent decides which CIK is correct using broader context (Wikidata founders, GitHub org alignment, the user's intent) and re-runs
```
funding --cik
```
to confirm.
```
signal
```
surfaces
```
Form D match is ambiguous
```
as its own signal class so cross-source consistency checks aren't trusted blindly.
Companies House /
legal --region uk
— UK Ltd / PLC only. Requires
```
COMPANIES_HOUSE_API_KEY
```
(free at developer.companieshouse.gov.uk).
GitHub /
engineering
— Any public org. Optional
```
GITHUB_TOKEN
```
raises rate limits from 60/hr to 5000/hr.
Hacker News /
mentions
/
launches
— Algolia full-text search across HN since 2007. No auth.
```
mentions
```
returns both a year-month histogram AND the top-N stories sorted by points (use
```
--top N
```
to widen, default 5).
```
launches
```
is the Show-HN-only flavor — use it for "did this company ever post a Show HN" questions; use
```
mentions
```
for "what do people say about this company on HN."
YC directory /
yc
— YC-backed companies only.
Wikidata /
wiki
— Sparse on early-stage; mostly useful for established companies.
RDAP / DNS /
domain
— Any registered domain.

SEC Form D /
funding
/
funding-trend
— 仅覆盖美国地区。包含Reg D定价轮次，不涵盖Pre-Series-A阶段的SAFE融资。对于非美国公司、未进入定价轮次的公司及尚未提交文件的公司，返回空文件及
```
coverage_note
```
是预期结果。当Form D无数据时，
```
funding
```
会 fallback 到更广泛的EDGAR全文搜索，并按信号类别展示提及内容：子公司（10-K母公司提及）、债务（风险租赁组合提及）、收购（8-K母公司披露）及其他类别。
```
funding --who
```
还会搜索所有类型的文件，而非仅Form D。歧义处理：EDGAR的全文搜索按名称片段匹配，因此“Notion”会同时匹配Notion Labs和Notion Capital VC。当多个不同CIK匹配时，结果会包含
```
cik_summaries
```
及
```
is_ambiguous: true
```
。可通过
```
--cik <id>
```
（摘要中的CIK）重新调用命令以筛选出正确实体。复合命令（
```
snapshot
```
、
```
compare
```
、
```
signal
```
）会在输出中传递歧义标记，且当存在歧义时不会生成并排对比数据——Agent需结合更广泛的上下文（Wikidata创始人信息、GitHub组织匹配度、用户意图）判断正确的CIK，再重新运行
```
funding --cik
```
确认。
```
signal
```
会将“Form D匹配存在歧义”作为独立信号类别展示，因此跨源一致性检查不会盲目信任结果。
Companies House /
legal --region uk
— 仅覆盖英国Ltd/PLC公司。需要
```
COMPANIES_HOUSE_API_KEY
```
（可在developer.companieshouse.gov.uk免费获取）。
GitHub /
engineering
— 覆盖所有公开组织。可选的
```
GITHUB_TOKEN
```
可将API调用速率限制从60次/小时提升至5000次/小时。
Hacker News /
mentions
/
launches
— 通过Algolia全文搜索2007年以来的HN内容，无需授权。
```
mentions
```
返回年月分布直方图及按点数排序的前N条热门内容（可使用
```
--top N
```
调整数量，默认5条）。
```
launches
```
仅展示Show HN内容——用于查询“该公司是否发布过Show HN”；
```
mentions
```
用于查询“HN上用户对该公司的评价”。
YC目录 /
yc
— 仅覆盖YC孵化的公司。
Wikidata /
wiki
— 早期初创公司数据较少，主要适用于成熟公司。
RDAP / DNS /
domain
— 覆盖所有已注册域名。

When Not to Use This CLI

何时不应使用本CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

请勿在需要创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或修改远程状态的请求中激活本CLI。本CLI仅提供用于查看、导出、同步及分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.

以下功能是其他同类工具所不具备的：

Multi-source orchestration

多源编排

snapshot
— Look up a company across SEC Form D, GitHub, Hacker News, Companies House, YC, Wikidata, and DNS in one command — rendered as a unified terminal summary in seconds.
When you need to evaluate a startup quickly, this is the one command that tells you whether they raised, are shipping code, are talked about, and are legitimate — without 8 browser tabs.
bash
```
company-goat-pp-cli snapshot --domain stripe.com --json
```
signal
— Surface suspicious cross-source patterns. Example: 'Form D says raised $5M in 2024 but GitHub org has 0 commits since 2022' or 'YC entry says Active but website domain expired'.
When deciding whether to engage with a startup, this command flags zombie companies and stale fundraising stories without you having to open every tab.
bash
```
company-goat-pp-cli signal --domain acme-corp.com --json
```

snapshot
— 一条命令即可跨SEC Form D、GitHub、Hacker News、Companies House、YC、Wikidata及DNS查询公司信息，并在数秒内生成统一的终端摘要。
当你需要快速评估一家初创公司时，这条命令可一次性告诉你该公司是否完成融资、是否在持续开发代码、是否受到关注及是否合法合规——无需打开8个浏览器标签页。
bash
```
company-goat-pp-cli snapshot --domain stripe.com --json
```
signal
— 识别跨源可疑模式。例如：“Form D显示2024年融资500万美元，但GitHub组织自2022年以来无任何提交记录”或“YC条目显示活跃状态，但网站域名已过期”。
在决定是否与某初创公司合作时，这条命令可标记僵尸公司及过时融资信息，无需逐一查看每个数据源。
bash
```
company-goat-pp-cli signal --domain acme-corp.com --json
```

Killer feature

核心亮点

funding
— See structured SEC Form D filings for a US private company — offering amount, filing date, exemption claimed (Reg D 506(b) vs 506(c)), related entities, and state of incorporation.
When an agent needs to verify a US startup's actual fundraising history, this is the single most reliable free signal. Avoid agents quoting Crunchbase Free's empty 'undisclosed' rows.
bash
```
company-goat-pp-cli funding --domain stripe.com --json
```
funding-trend
— Time series of Form D filings for a company across years — shows fundraising cadence and gaps. Useful for spotting 'they haven't raised since 2022' silently.
Use this when an agent needs to summarize a company's fundraising arc, not just the latest round.
bash
```
company-goat-pp-cli funding-trend --domain stripe.com --since 2018 --json
```
funding --who
— Show every Form D filing that names a given person (officer, large holder). Reveals serial founders, repeat advisors, prolific investors.
Use when an agent needs to map who's behind a constellation of startups, or verify a founder's actual filing history.
bash
```
company-goat-pp-cli funding --who 'Patrick Collison' --json
```

funding
— 查看美国私营公司的结构化SEC Form D文件，包括融资额、提交日期、申请的豁免条款（Reg D 506(b) vs 506(c)）、关联实体及注册州。
当Agent需要验证美国初创公司的实际融资历史时，这是最可靠的免费信号来源。避免Agent引用Crunchbase免费版中显示“未披露”的空行。
bash
```
company-goat-pp-cli funding --domain stripe.com --json
```
funding-trend
— 公司历年Form D提交记录的时间序列，展示融资节奏及间隔。可用于发现“自2022年以来未进行融资”等潜在信息。
当Agent需要总结公司的融资历程，而非仅查看最新一轮融资时，可使用此命令。
bash
```
company-goat-pp-cli funding-trend --domain stripe.com --since 2018 --json
```
funding --who
— 展示所有提及指定人员（高管、大额持有人）的Form D文件。可用于发现连续创业者、重复顾问及活跃投资者。
当Agent需要梳理某初创公司背后的人员关系，或验证创始人的实际提交记录时，可使用此命令。
bash
```
company-goat-pp-cli funding --who 'Patrick Collison' --json
```

Local state that compounds

可积累的本地状态

search
— Search the YC directory by free text + --batch and --industry filters. Free-text matches against name, one-liner description, industry, and location.
An agent tasked with 'find a YC fintech with "agent" in the description' has a one-shot query rather than scrolling the YC directory.
bash
```
company-goat-pp-cli search 'agent' --industry fintech
```
compare
— Two snapshots aligned column-by-column for direct comparison. Free in this CLI; paid feature elsewhere.
When evaluating two competing startups, this is the one-shot comparison that doesn't require flipping between tabs.
bash
```
company-goat-pp-cli compare stripe.com adyen.com --json
```

search
— 通过自由文本+
```
--batch
```
和
```
--industry
```
筛选条件搜索YC目录。自由文本匹配公司名称、一句话描述、行业及地点。
Agent只需一条命令即可完成“查找YC孵化的、描述中包含‘agent’的金融科技公司”这类任务，无需手动浏览YC目录。
bash
```
company-goat-pp-cli search 'agent' --industry fintech
```
compare
— 将两家公司的快照按列对齐，进行直接对比。此功能在本CLI中免费，在其他工具中为付费功能。
在评估两家竞争初创公司时，这条命令可一次性完成对比，无需在标签页间切换。
bash
```
company-goat-pp-cli compare stripe.com adyen.com --json
```

Command Reference

命令参考

filings — SEC EDGAR Form D filings — the primary data source for US private fundraising disclosure

```
company-goat-pp-cli filings
```
— Fetch all SEC submissions for a given CIK (Central Index Key). Used as the seed call when resolving a company's...

Hand-written commands

```
company-goat-pp-cli resolve <name-or-domain>
```
— Resolve a company name to a canonical domain. Returns numbered candidates if ambiguous; --pick N or --domain to...
```
company-goat-pp-cli funding <co>
```
— SEC EDGAR Form D filings + YC batch lookup. Shows offering amount, filing date, exemption claimed, related entities...
```
company-goat-pp-cli engineering <co>
```
— GitHub org metadata: repo count, contributor count, commit cadence, top languages.
```
company-goat-pp-cli launches <co>
```
— Show HN posts about this company, sorted by points. Includes launch year for spotting dead vs. active launches.
```
company-goat-pp-cli mentions <co>
```
— Hacker News mention timeline: monthly histogram of mentions over time via Algolia full-text search.
```
company-goat-pp-cli legal <co>
```
— Legal entity lookup. UK via Companies House (optional COMPANIES_HOUSE_API_KEY); US via SEC EDGAR Form D issuer...
```
company-goat-pp-cli yc <co>
```
— Y Combinator directory entry if the company was YC-backed: batch, status, location, description.
```
company-goat-pp-cli wiki <co>
```
— Wikidata company facts: founded date, founders, HQ, industry, key people. Sparse on early-stage startups.
```
company-goat-pp-cli domain <co>
```
— Domain age via RDAP/WHOIS, DNS records, and CNAME-based hosting hint (Vercel/Netlify/Heroku/Cloudflare Pages/AWS/GCP).
```
company-goat-pp-cli snapshot <co>
```
— Fan out across all 7 sources in parallel and render a unified summary. The headline command. Uses cliutil.FanoutRun...
```
company-goat-pp-cli compare <a> <b>
```
— Two snapshots side-by-side, aligned by section. For evaluating which of two startups looks healthier.
```
company-goat-pp-cli search <query>
```
— Search the YC directory by free text +
```
--batch
```
and
```
--industry
```
filters. Cross-source FTS5 over the synced store is on the v1 roadmap; today this is YC-only.
```
company-goat-pp-cli signal <co>
```
— Cross-source consistency check. Flags suspicious patterns like 'raised in 2024 but no GitHub commits since 2022'....
```
company-goat-pp-cli funding-trend <co>
```
— Time series of Form D filings over time. Useful for charting a startup's fundraising cadence.
```
company-goat-pp-cli sync
```
— Pull syncable resources (YC directory and any other configured) into local SQLite. Use
```
--resources
```
to pick a subset. Subsequent reads with
```
--data-source local
```
query offline.

filings — SEC EDGAR Form D文件，美国私营公司融资披露的主要数据源

```
company-goat-pp-cli filings
```
— 获取指定CIK（Central Index Key）的所有SEC提交文件。用于解析公司的...

手动编写的命令

```
company-goat-pp-cli resolve <name-or-domain>
```
— 将公司名称解析为标准域名。若存在歧义则返回编号候选结果；可使用
```
--pick N
```
或
```
--domain
```
...
```
company-goat-pp-cli funding <co>
```
— SEC EDGAR Form D文件+YC批量查询。展示融资额、提交日期、申请的豁免条款、关联实体...
```
company-goat-pp-cli engineering <co>
```
— GitHub组织元数据：仓库数量、贡献者数量、提交频率、Top语言。
```
company-goat-pp-cli launches <co>
```
— 展示该公司的Show HN帖子，按点数排序。包含发布年份，用于区分活跃与已停止的项目。
```
company-goat-pp-cli mentions <co>
```
— Hacker News提及时间线：通过Algolia全文搜索生成的月度提及分布直方图。
```
company-goat-pp-cli legal <co>
```
— 法律实体查询。英国地区通过Companies House（可选
```
COMPANIES_HOUSE_API_KEY
```
）；美国地区通过SEC EDGAR Form D发行人...
```
company-goat-pp-cli yc <co>
```
— 若公司为YC孵化，展示YC目录条目：批次、状态、地点、描述。
```
company-goat-pp-cli wiki <co>
```
— Wikidata公司信息：成立日期、创始人、总部、行业、关键人员。早期初创公司数据较少。
```
company-goat-pp-cli domain <co>
```
— 通过RDAP/WHOIS查询域名年限、DNS记录及基于CNAME的托管提示（Vercel/Netlify/Heroku/Cloudflare Pages/AWS/GCP）。
```
company-goat-pp-cli snapshot <co>
```
— 并行调用所有7个数据源，生成统一摘要。这是核心命令。使用cliutil.FanoutRun...
```
company-goat-pp-cli compare <a> <b>
```
— 将两家公司的快照按章节并排对齐，用于评估哪家初创公司更健康。
```
company-goat-pp-cli search <query>
```
— 通过自由文本+
```
--batch
```
和
```
--industry
```
筛选条件搜索YC目录。跨源FTS5同步存储功能已列入v1 roadmap；目前仅支持YC目录搜索。
```
company-goat-pp-cli signal <co>
```
— 跨源一致性检查。标记可疑模式，如“2024年完成融资但GitHub自2022年以来无提交记录”...
```
company-goat-pp-cli funding-trend <co>
```
— Form D提交记录的时间序列，用于绘制初创公司的融资节奏图表。
```
company-goat-pp-cli sync
```
— 将可同步资源（YC目录及其他配置资源）拉取到本地SQLite。可使用
```
--resources
```
选择子集。后续使用
```
--data-source local
```
可离线查询。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:

bash

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

which

resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当你知道要做什么但不确定对应命令时，可直接询问CLI：

bash

company-goat-pp-cli which "<用你自己的话描述功能>"

which

命令会将自然语言功能查询解析为本CLI精选功能索引中最匹配的命令。退出码

表示至少有一个匹配项；退出码

表示无匹配项——此时可使用

--help

或缩小查询范围。

Recipes

使用示例

Quick due diligence on a US startup

美国初创公司快速尽职调查

bash

company-goat-pp-cli snapshot --domain anthropic.com --json

Fan out across all 7 sources and render a unified summary. Use

--domain

to skip name resolution and go straight to the canonical entity. Each source returns

{status, data, note, elapsed}

so partial failures are visible.

bash

company-goat-pp-cli snapshot --domain anthropic.com --json

并行调用所有7个数据源，生成统一摘要。使用

--domain

可跳过名称解析，直接查询标准实体。每个数据源返回

{status, data, note, elapsed}

，因此可查看部分失败情况。

Find every SEC filing for a founder

查找某创始人的所有SEC文件

bash

company-goat-pp-cli funding --who 'Patrick Collison' --json

Returns every Form D filing where this person is named — useful for mapping serial founders and repeat investors.

bash

company-goat-pp-cli funding --who 'Patrick Collison' --json

返回所有提及该人员的Form D文件——用于梳理连续创业者及重复投资者的关系。

Compare two competing startups

对比两家竞争初创公司

bash

company-goat-pp-cli compare ramp.com brex.com

Aligns snapshots side-by-side; agent-readable. Use for tradeoff analysis.

bash

company-goat-pp-cli compare ramp.com brex.com

将两家公司的快照并排对齐，便于Agent阅读。用于权衡分析。

Build a research database

构建调研数据库

bash

company-goat-pp-cli sync && company-goat-pp-cli search 'fintech'

Pulls the YC directory and any other syncable resources into local SQLite, then full-text searches the synced index. Subsequent reads can use

--data-source local

to query offline.

bash

company-goat-pp-cli sync && company-goat-pp-cli search 'fintech'

将YC目录及其他可同步资源拉取到本地SQLite，然后对同步索引进行全文搜索。后续可使用

--data-source local

离线查询。

Surface suspicious patterns

识别可疑模式

bash

company-goat-pp-cli signal --domain acme-corp.com --json

Cross-source consistency check — flags cases like 'raised $X in 2024 but GitHub silent since 2022' that no single source would catch.

bash

company-goat-pp-cli signal --domain acme-corp.com --json

跨源一致性检查——标记单个数据源无法发现的情况，如“2024年融资X美元但GitHub自2022年以来无活动记录”。

Auth Setup

授权设置

No required keys. Three optional environment variables expand coverage and rate limits:

```
COMPANY_PP_CONTACT_EMAIL=you@example.com
```
— Sent in the SEC EDGAR User-Agent header to comply with EDGAR's fair-access policy. Recommended for any non-trivial use of
```
funding
```
/
```
funding-trend
```
/
```
snapshot
```
.
```
GITHUB_TOKEN
```
— Raises GitHub API rate limit from 60/hr to 5000/hr.
```
gh auth token
```
works. Used by
```
engineering
```
,
```
snapshot
```
.
```
COMPANIES_HOUSE_API_KEY
```
— Required for
```
legal --region uk
```
. Register free at developer.companieshouse.gov.uk and create a REST application.

SEC EDGAR requests are paced and retried automatically. The CLI honors

Retry-After

, backs off on 429/5xx responses, and exits with code 7 if SEC continues throttling after retries.

Run

company-goat-pp-cli doctor

to verify which of these are detected.

无必填密钥。三个可选环境变量可扩展覆盖范围及提升速率限制：

```
COMPANY_PP_CONTACT_EMAIL=you@example.com
```
— 在SEC EDGAR User-Agent头中发送，以符合EDGAR的公平访问政策。对于
```
funding
```
/
```
funding-trend
```
/
```
snapshot
```
的非 trivial 使用，推荐设置此变量。
```
GITHUB_TOKEN
```
— 将GitHub API调用速率限制从60次/小时提升至5000次/小时。可使用
```
gh auth token
```
获取。用于
```
engineering
```
、
```
snapshot
```
命令。
```
COMPANIES_HOUSE_API_KEY
```
— 使用
```
legal --region uk
```
时必填。可在developer.companieshouse.gov.uk免费注册并创建REST应用。

SEC EDGAR请求会自动调整速率并重试。CLI会遵守

Retry-After

头，在收到429/5xx响应时退避，若SEC持续限流则退出码为7。

执行

company-goat-pp-cli doctor

可验证上述变量是否已被检测到。

Agent Mode

Agent模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
company-goat-pp-cli filings --agent --select id,name,status
```
Previewable —
```
--dry-run
```
shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

在任何命令后添加

--agent

，等效于：

--json --compact --no-input --no-color --yes

。

可管道化 — stdout输出JSON，stderr输出错误信息
可筛选 —
```
--select
```
保留指定字段子集。点路径可深入嵌套结构；数组可遍历元素。对于冗长API，此功能对缩小上下文至关重要：
bash
```
company-goat-pp-cli filings --agent --select id,name,status
```
可预览 —
```
--dry-run
```
显示请求但不发送
离线友好 — 同步/搜索命令可使用本地SQLite存储（若可用）
非交互式 — 从不提示，所有输入均通过标志传递
只读 — 请勿使用本CLI执行创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他修改状态的请求

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:

json

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

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

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

json

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

解析

.results

获取数据，

.meta.source

表示数据是实时还是本地的。仅当stdout为终端时，才会向stderr打印人类可读的

N results (live)

摘要——管道/Agent消费者仅会在stdout获取纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:

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

Entries are stored locally at

~/.company-goat-pp-cli/feedback.jsonl

. They are never POSTed unless

COMPANY_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

COMPANY_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当你（或Agent）发现本CLI存在问题时，可记录反馈：

company-goat-pp-cli feedback "--since标志为包含性，但文档说明为排他性"
company-goat-pp-cli feedback --stdin < notes.txt
company-goat-pp-cli feedback list --json --limit 10

反馈条目存储在本地

~/.company-goat-pp-cli/feedback.jsonl

。仅当设置了

COMPANY_FEEDBACK_ENDPOINT

且传递了

--send

或设置

COMPANY_FEEDBACK_AUTO_SEND=true

时，才会POST反馈。默认仅存储在本地。

请写下让你感到意外的内容，而非正式的bug报告。简短、具体、一句话即可：这才是有价值的反馈。

Output Delivery

输出交付

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

每个命令都支持

--deliver <sink>

。输出会发送到指定sink（替代或附加到stdout），因此Agent无需手动管道即可路由命令结果。支持三种sink：

Sink	效果
`stdout`	默认；仅输出到stdout
`file:<path>`	原子性地将输出写入 `<path>` （先写入临时文件再重命名）
`webhook:<url>`	将输出体POST到指定URL（ `application/json` 格式；若使用 `--compact` 则为 `application/x-ndjson` 格式）

不支持的协议会返回结构化错误，列出支持的类型。Webhook失败时返回非零退出码，并在stderr记录URL及HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

company-goat-pp-cli profile save briefing --json
company-goat-pp-cli --profile briefing filings
company-goat-pp-cli profile list --json
company-goat-pp-cli profile show briefing
company-goat-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是一组保存的标志值，可在多次调用中复用。适用于调度Agent每次运行相同命令且配置相同的场景——即HeyGen的“Beacon”模式。

company-goat-pp-cli profile save briefing --json
company-goat-pp-cli --profile briefing filings
company-goat-pp-cli profile list --json
company-goat-pp-cli profile show briefing
company-goat-pp-cli profile delete briefing --yes

显式标志优先级高于配置文件值；配置文件值优先级高于默认值。

agent-context

会在

available_profiles

下列出所有可用配置文件，因此Agent可在运行时发现它们。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

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

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
company-goat-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

：

为空、
help
或
--help
→ 显示
```
company-goat-pp-cli --help
```
输出
以
install
开头 → 若结尾为
```
mcp
```
→ MCP安装；否则 → 参见上方前提条件
其他情况 → 直接使用（添加
```
--agent
```
执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP server:

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/company-goat/cmd/company-goat-pp-mcp@latest

bash

claude mcp add company-goat-pp-mcp -- company-goat-pp-mcp

Verify:
```
claude mcp list
```

安装MCP服务器：

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/company-goat/cmd/company-goat-pp-mcp@latest

注册到Claude Code：

bash

claude mcp add company-goat-pp-mcp -- company-goat-pp-mcp

验证：
```
claude mcp list
```

Direct Use

直接使用

Check if installed:
```
which company-goat-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

company-goat-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
company-goat-pp-cli <command> --help
```
.

检查是否已安装：
```
which company-goat-pp-cli
```
若未找到，提供安装选项（参见顶部前提条件）。
将用户查询与上述独特功能及命令参考中最匹配的命令关联。

添加

--agent

标志执行：

bash

company-goat-pp-cli <command> [subcommand] [args] --agent

若存在歧义，查看子命令帮助：
```
company-goat-pp-cli <command> --help
```
。