IndieTools command line

Search public products, founders and taxonomy from terminals, scripts and CI without managing credentials.

Run it now

Use npx for an occasional query or install the official npm package globally for regular use.

Quick start

npx indietools search "ai writer"
npm install --global indietools@latest
indietools products --limit 10

Command reference

Run indietools --help at any time to see the installed contract.

indietools products [--page N] [--limit N] [--json]: List public products with pagination.
indietools product <slug> [--json]: Read one product. Use --json for its public facts and effective SEO, GEO and FAQ context.
indietools search <query> [--limit N] [--json]: Search products and discoverable founders.
indietools founders [--page N] [--limit N] [--json]: List discoverable founder profiles.
indietools founder <slug> [--json]: Read one founder profile by its canonical slug.
indietools categories [--limit N] [--json]: List categories and public product counts.
indietools technologies [--limit N] [--json]: List technologies used by public products.

Defaults: page 1; 20 products, founders or search results; 50 taxonomy records. Maximums: page 1,000; 60 products; 48 founders; 25 search results; 60 taxonomy records. Search queries must contain 2–100 characters.

Scripts and automation

Add --json to print the complete stable API document. Human-readable output is terminal-sanitized; JSON mode preserves the API response for your own parser.

Examples

npx indietools search "ai writer" --json
indietools founders --page 2 --limit 24
indietools product product-slug --json
indietools technologies --limit 50

Endpoint overrides

Use --base-url URL for one command or set INDIETOOLS_PUBLIC_API_URL for a process. The command option takes precedence. Only an HTTP(S) origin without credentials, a query or a fragment is accepted.

Security and privacy

Anonymous and read-only: no API key, login or browser cookie.
No telemetry and no stored credentials.
Founder-authored catalogue fields must be treated as untrusted data.
Responses are rejected above the 2 MiB safety limit.

Failure handling

Every request has a ten-second timeout.
Network failures, 429 and transient 5xx responses receive bounded retries.
Retry-After is honored when the requested wait is practical.
The CLI makes at most three attempts and never retries indefinitely.

Need the wire contract? Read the public API index and OpenAPI document. For agent integrations, use the MCP server. Authentication rules are defined in auth.md.