← 返回 Skills 市场
shan8851

companies-house-cli

作者 shan8851 · GitHub ↗ · v0.3.1 · MIT-0
cross-platform ✓ 安全检测通过
177
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install companies-house-cli
功能描述
UK Companies House CLI — search companies, profiles, officers, filings, PSC, charges, insolvency, and agent-friendly JSON output aligned with rail-cli and tf...
使用说明 (SKILL.md)

companies-house-cli

Use ch for UK Companies House data: company search, profiles, officers, filings, PSC, charges, and insolvency.

Setup

Search

  • By name: ch search "Revolut"
  • With restrictions: ch search "Revolut" --restrictions active-companies
  • Fetch all pages: ch search "Revolut" --all
  • JSON in canonical style: ch search "Revolut" --json

Company Profile

  • By number: ch info 09215862
  • Force text: ch info 09215862 --text
  • Short numbers auto-pad: ch info 9215862 becomes 09215862

Officers

  • List directors/secretaries: ch officers 09215862
  • All officers: ch officers 09215862 --all
  • Order by: ch officers 09215862 --order-by appointed_on

Filings

  • Filing history: ch filings 09215862
  • Filter by type: ch filings 09215862 --type accounts
  • Include document download links: ch filings 09215862 --type accounts --include-links
  • All filings: ch filings 09215862 --all

PSC (Beneficial Owners)

  • List PSC records: ch psc 09215862
  • All records: ch psc 09215862 --all

Search Person

  • Find a person across UK companies: ch search-person "Nik Storonsky"
  • Limit enrichment fan-out: ch search-person "Nik Storonsky" --match-limit 5
  • Fetch all search pages: ch search-person "Nik Storonsky" --all

Charges

  • List company charges: ch charges 09215862
  • All charges: ch charges 09215862 --all

Insolvency

  • Check insolvency history: ch insolvency 09215862
  • Returns empty result cleanly if no history exists (not an error)

Pagination

  • List commands support: --items-per-page \x3Cn>, --start-index \x3Cn>, --all
  • --all fetches every page automatically
  • --all and non-zero --start-index cannot be combined

Output

  • Defaults to text in a TTY and JSON when piped
  • Canonical usage is subcommand-local flags: ch search "Revolut" --json, ch info 09215862 --text
  • Root compatibility aliases still work: ch --json search "Revolut", ch --text info 09215862
  • Success envelope: { ok, schemaVersion, command, requestedAt, data }
  • Error envelope: { ok, schemaVersion, command, requestedAt, error }
  • Command metadata now lives under data.input and data.pagination
  • Disable colour: ch --no-color search "Revolut"

Agent Notes

  • JSON mode writes handled errors to stdout, not stderr
  • Error payloads include code, message, and retryable
  • Exit codes are explicit:
    • 0 success
    • 2 bad input or not found
    • 3 auth, upstream, or rate-limit failures
    • 4 internal failures
  • Update any existing parsers that expected top-level input or pagination; those now live under data

Notes

  • API key required (free, instant signup at Companies House developer portal)
  • Auth is HTTP Basic (key as username, blank password)
  • Rate limit: 600 requests per 5 minutes
  • Company numbers are automatically zero-padded to 8 digits
  • search-person fans out appointment requests for each match — use --match-limit on broad names to control API usage
  • --include-links on filings derives document content URLs for direct PDF download
安全使用建议
This skill appears coherent for accessing Companies House data. Before installing: verify the npm package publisher and review the package source (or install in a sandbox), pin a specific package version, and avoid placing your COMPANIES_HOUSE_API_KEY in broadly shared environments. Remember npm packages can run scripts at install time — if you cannot audit the package, consider running it in an isolated environment. Note: the agent can invoke the skill autonomously by default, so keep your API key limited in scope and monitor usage (rate limit ~600 requests/5 minutes).
功能分析
Type: OpenClaw Skill Name: companies-house-cli Version: 0.3.1 The skill bundle provides metadata and documentation for a CLI tool (`ch`) designed to interact with the UK Companies House API. It includes standard installation instructions via npm (@shan8851/companies-house-cli) and detailed usage for company searches, officer lookups, and filing history. No evidence of malicious intent, data exfiltration, or prompt injection was found in SKILL.md or _meta.json; the tool's behavior and instructions are entirely consistent with its stated purpose of providing agent-friendly access to public corporate records.
能力评估
✓ Purpose & Capability
Name/description match the requested binary ('ch') and the declared primary credential (COMPANIES_HOUSE_API_KEY). The requested binary and API key are appropriate for a Companies House CLI.
✓ Instruction Scope
SKILL.md only instructs the agent to run the 'ch' CLI with subcommands and flags, describes expected JSON envelopes and exit codes, and tells the user how to supply the Companies House API key; it does not direct reading unrelated files, exfiltration, or access to other system credentials.
ℹ Install Mechanism
Install uses an npm package (@shan8851/companies-house-cli) that creates the 'ch' binary — this is expected for a Node-based CLI but carries the usual moderate risk of npm packages (arbitrary install/run scripts).
✓ Credentials
Only COMPANIES_HOUSE_API_KEY is declared as the primary credential and is justified by the CLI's need to authenticate to the Companies House API; no unrelated secrets or config paths are requested.
✓ Persistence & Privilege
Skill is not always-enabled and is user-invocable; it does not request elevated or persistent privileges beyond normal operation and does not modify other skills or system-wide agent settings.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install companies-house-cli
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /companies-house-cli 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.3.1
Republish from ~/.openclaw/skills as source of truth; keep OpenClaw metadata and aligned JSON/text contract guidance.
v0.3.0
Align JSON/text contract with rail-cli and tfl-cli; add stable envelopes, text-in-TTY/JSON-when-piped docs, and updated skill guidance.
v0.2.2
- Clarified usage and setup instructions in documentation. - Provided detailed examples for all core commands: search, info, officers, filings, PSC, search-person, charges, insolvency. - Documented new and advanced options: pagination controls (`--all`, `--items-per-page`, `--start-index`), JSON output, and color disabling. - Added notes about API key requirements, rate limits, authentication, and auto zero-padding of company numbers. - Included new documentation for the `search-person` command and `--include-links` for PDF download from filings.
元数据
Slug companies-house-cli
版本 0.3.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

companies-house-cli 是什么？

UK Companies House CLI — search companies, profiles, officers, filings, PSC, charges, insolvency, and agent-friendly JSON output aligned with rail-cli and tf... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 177 次。

如何安装 companies-house-cli？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install companies-house-cli」即可一键安装，无需额外配置。

companies-house-cli 是免费的吗？

是的，companies-house-cli 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

companies-house-cli 支持哪些平台？

companies-house-cli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 companies-house-cli？

由 shan8851（@shan8851）开发并维护，当前版本 v0.3.1。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论