How do I install the Company Research CLI skill?

Run npx skillmds@latest add riftwerx/company-research-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Company Research CLI skill do?

Workflow guide for using company-research as a CLI tool via Bash It is listed under Research & Search on SkillMD.

Is Company Research CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Company Research CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Company Research CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Company Research CLI?

RiftWerx (@riftwerx) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Company Research CLI by riftwerx — Agent Skill

Name: Company Research CLI
Author: RiftWerx

File contents

company-research CLI workflow

Setup

CH_API_KEY must be set in the environment — not accepted as a CLI flag.

All commands output JSON to stdout; errors go to stderr with exit 1. Use jq to extract fields.

Command reference

search-company <query> [-l/--limit N]
get-company-profile <ch-number>
list-filings <ch-number> [-c/--category STR] [--start N] [-l/--limit N]
fetch-filing <ch-number> <document-id>
get-latest <ch-number> <category>
list-zip-contents <ch-number> <document-id>
extract-xbrl-facts <local-path> [--name-prefix STR] [--include-text-facts]
clear-cache [--ch-number STR]

Canonical sequence

company-research search-company "Tesco"                     # pick ch_number
company-research list-filings 00445790 --category accounts  # pick document_id
company-research fetch-filing 00445790 <document_id>        # get local_path
company-research extract-xbrl-facts <local_path>            # financial facts

get-latest shortcut — replaces list-filings + fetch-filing:

company-research get-latest 00445790 accounts

Key facts

CH numbers are zero-padded to 8 digits: 00445790 not 445790
list-filings common categories: accounts, confirmation-statement; omit --category to discover all
document_id is an opaque UUID from list-filings/get-latest output — never construct it
extract-xbrl-facts takes local_path (from fetch-filing/get-latest output), not document_id

ZIP archives

When fetch-filing/get-latest returns "is_archive": true:

company-research list-zip-contents 00445790 <document_id>  # pick entry: is_primary or content_type
company-research extract-xbrl-facts <entry_local_path>

PDF-rendered iXBRL

When extract-xbrl-facts returns "render_type": "pdf_rendered": XBRL facts are present but narrative text is inaccessible. Check warnings for alternative formats.

---name: company-research-clidescription: Workflow guide for using company-research as a CLI tool via Bash---# company-research CLI workflow## Setup`CH_API_KEY` must be set in the environment — not accepted as a CLI flag.All commands output JSON to stdout; errors go to stderr with exit 1. Use `jq` to extract fields.## Command reference```search-company <query> [-l/--limit N]get-company-profile <ch-number>list-filings <ch-number> [-c/--category STR] [--start N] [-l/--limit N]fetch-filing <ch-number> <document-id>get-latest <ch-number> <category>list-zip-contents <ch-number> <document-id>extract-xbrl-facts <local-path> [--name-prefix STR] [--include-text-facts]clear-cache [--ch-number STR]```## Canonical sequence```bashcompany-research search-company "Tesco" # pick ch_numbercompany-research list-filings 00445790 --category accounts # pick document_idcompany-research fetch-filing 00445790 <document_id> # get local_pathcompany-research extract-xbrl-facts <local_path> # financial facts````get-latest` shortcut — replaces `list-filings` + `fetch-filing`:```bashcompany-research get-latest 00445790 accounts```## Key facts- CH numbers are zero-padded to 8 digits: `00445790` not `445790`- `list-filings` common categories: `accounts`, `confirmation-statement`; omit `--category` to discover all- `document_id` is an opaque UUID from `list-filings`/`get-latest` output — never construct it- `extract-xbrl-facts` takes `local_path` (from `fetch-filing`/`get-latest` output), **not** `document_id`## ZIP archivesWhen `fetch-filing`/`get-latest` returns `"is_archive": true`:```bashcompany-research list-zip-contents 00445790 <document_id> # pick entry: is_primary or content_typecompany-research extract-xbrl-facts <entry_local_path>```## PDF-rendered iXBRLWhen `extract-xbrl-facts` returns `"render_type": "pdf_rendered"`: XBRL facts are present but narrative text is inaccessible. Check `warnings` for alternative formats.

Frequently asked questions

Company Research CLI