akta.pro CLI (akta-pro)

A command-line client for the akta.pro REST API (https://api.akta.pro/api/v1) — a sibling of the akta.pro MCP server. Both are thin clients over the same endpoints; the CLI is the presentation layer for humans and shell scripts. It ships as its own self-contained distribution (akta-pro-cli) with no MCP-server code.

Source: src/akta_pro_cli/. API reference: https://docs.akta.pro.

Install

Published on PyPI. Install with pipx (recommended for CLIs — isolated env) or pip:

pipx install akta-pro-cli
# or
pip install akta-pro-cli

Then run akta-pro --help. Full prerequisites, auth, update, and troubleshooting steps are in INSTALL.md.

The akta-pro command depends only on httpx, typer, rich.

Authentication

v1 authenticates with an akta.pro API key (wk_...), minted at https://playground.akta.pro (sign up → API Keys). Three ways to supply it, in precedence order:

akta-pro --api-key wk_...  company search Canva     # 1. explicit flag
export AKTA_PRO_API_KEY=wk_...                       # 2. environment variable
akta-pro login                                       # 3. stored (prompts, or --api-key)

akta-pro login validates the key against a free endpoint and stores it at ~/.config/akta-pro/credentials.json (mode 0600; %APPDATA%\akta-pro on Windows).

akta-pro login --api-key wk_...   # store without the prompt
akta-pro whoami                   # show the active key (masked), its source, and validate
akta-pro logout                   # remove the stored key

Commands

company data sections (each billed separately): firmographic, business_model, company_assessment, trust_signal, company_hierarchy, digital_presence, financial_estimate, location, management_profile, product_offering, strategic_signal, customer_profile, industry, technology, plus enterprise-only funding_detail (3) and mna_and_investment (5). There is no "all" — choose explicitly. The two enterprise sections are auto-skipped (not an error) for non-enterprise callers, with a note.

Run akta-pro <command> --help for every flag.

Examples

akta-pro account                                                  # check tier + credits
akta-pro company search "Canva"
akta-pro company data canva.com -s firmographic -s technology     # rendered Markdown
akta-pro company data canva.com -s firmographic --raw             # raw Markdown (pipe/save)
akta-pro industry search "warehouse automation"
akta-pro news types                                               # find type codes
akta-pro news signals --company canva.com -t SD01 -n 20           # product-launch news
akta-pro news signals --query "crude oil prices" --json | jq '.data[].id'
akta-pro news detail 12345 12346                                  # full bodies for those ids
akta-pro headcount canva.com
akta-pro reviews products canva.com                               # list catalog + ids
akta-pro reviews products canva.com --product-id p_123 -n 50
akta-pro company add "Solios" solios.co                           # request a missing company
akta-pro status <request_id>                                      # poll that request
akta-pro list filters                                             # which fields --filters accepts
akta-pro list filter-options location.hq.country                  # -> allowed values for that field
akta-pro list filter-builder "US fintechs founded after 2015"     # -> structured filters
akta-pro list generate companies --filters '{"location.hq.country":"USA"}' -s firmographic

Output & exit codes

• Default (TTY): a Rich table for list results (search, industry, news), rendered Markdown for company data, and pretty-printed JSON for nested objects.
• --json: clean, unstyled JSON on stdout (valid for | jq). Applied automatically when stdout is piped/redirected. For company data, --json (alias --raw) emits the raw Markdown.
• -o/--output FILE: writes the raw JSON/text payload to a file.
• credits_consumed is printed to stderr (silence with -q/--quiet), so it never pollutes piped JSON.

Exit codes: 0 success · 2 bad input · 3 auth (no/invalid key or 403) · 4 other API/network error · 5 timeout.