Developer Tools

Rapidapi

rapidapi-pp-cli

RapidAPI Hub marketplace CLI - search APIs, browse categories & collections, inspect providers

Printed by @SomSamantray (Som Samantray)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install rapidapi

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-rapidapi --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-rapidapi skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-rapidapi. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

RapidAPI Hub marketplace CLI - search APIs, browse categories & collections, inspect providers, and manage your account (subscriptions, favorites, notifications, workspace) via the hub's own GraphQL gateway

Learn more at Rapidapi.

Created by @SomSamantray (Som Samantray).

Authentication

The RapidAPI hub gateway authenticates with a session cookie (rapidapi-context-id) plus a session-bound CSRF token auto-fetched at request time — even public marketplace queries need the CSRF bootstrap.

Set the cookie (your RapidAPI user ID — find it in Chrome DevTools → Application → Cookies → https://rapidapi.com → rapidapi-context-id):

export RAPIDAPI_COOKIE="<rapidapi-context-id value>"
# or persist it
rapidapi-pp-cli auth login --cookie "<value>"

Cloudflare-gated networks: set the cf_clearance cookie (DevTools → Application → Cookies) too:

export RAPIDAPI_CLEARANCE="<cf_clearance value>"
# or
rapidapi-pp-cli auth login --clearance "<value>"

Account commands (account whoami, account subscriptions, account notifications) additionally require the browser session's HttpOnly cookies and return empty results without them.

Quick Start

1. Install

See Install above.

2. Set Up Credentials

Get your API key from your API provider's developer portal. The key typically looks like a long alphanumeric string.

export RAPIDAPI_CSRF_TOKEN="<paste-your-key>"

3. Verify Setup

rapidapi-pp-cli doctor

This checks your configuration and credentials.

4. Try Your First Command

rapidapi-pp-cli categories --limit 10

Usage

Run rapidapi-pp-cli --help for the full command reference and flag list.

Paths & environment variables

This CLI separates local files into four path kinds:

Kind	Contents
`config`	User-editable settings such as `config.toml` and saved profiles
`data`	Durable local data: `credentials.toml`, `data.db`, cookies, browser-session proof files, and other auth sidecars
`state`	Runtime state such as persisted queries, jobs, and `teach.log`
`cache`	Regenerable HTTP/cache files

Each kind resolves independently. The ladder is:

Per-kind env var: RAPIDAPI_CONFIG_DIR, RAPIDAPI_DATA_DIR, RAPIDAPI_STATE_DIR, or RAPIDAPI_CACHE_DIR
--home <dir> for this invocation
RAPIDAPI_HOME for a flat relocated root
XDG env vars: XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_STATE_HOME, XDG_CACHE_HOME
Platform defaults matching existing installs

For containers and agent sandboxes, prefer a single relocated root:

export RAPIDAPI_HOME=/srv/rapidapi
rapidapi-pp-cli doctor

Under RAPIDAPI_HOME=/srv/rapidapi, the four dirs resolve to /srv/rapidapi/config, /srv/rapidapi/data, /srv/rapidapi/state, and /srv/rapidapi/cache.

MCP servers do not receive CLI flags from the host. Put relocation in the host env block:

{
  "mcpServers": {
    "rapidapi": {
      "command": "rapidapi-pp-mcp",
      "env": {
        "RAPIDAPI_HOME": "/srv/rapidapi"
      }
    }
  }
}

Precedence matters in fleets: an ambient per-kind variable such as RAPIDAPI_DATA_DIR overrides an explicit --home for that kind. Use RAPIDAPI_HOME or the per-kind variables for durable fleet relocation; treat --home as the weaker per-invocation lever.

Relocation is one-way. Unsetting RAPIDAPI_HOME does not move files back to platform defaults, and doctor cannot find credentials left under a former root. Move the files manually before unsetting relocation variables.

Existing installs keep working because the platform-default rung matches the legacy layout. On the first auth write, stored secrets leave config.toml and are consolidated into credentials.toml under the data directory. Run rapidapi-pp-cli doctor --fail-on warn to check path and credential-location warnings in automation.

Unique Features

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

Offline marketplace sync & search

sync — Pull categories, collections, and top APIs into a local SQLite store with sync-state tracking; search then queries the cached data offline.

Choose this when you need repeated marketplace research without re-hitting the hub every time.

Hub analytics with local aggregation

analytics / stats / trends — Hub-wide metrics (APIs, users, traffic) plus per-day request/error aggregates computed locally (SUM, AVG, error rates, day-over-day deltas).

Choose this when you need usage trends or a hub pulse without a dashboard.

Chrome TLS transport

system csrf — The CLI's uTLS Chrome-fingerprint HTTP/2 transport passes the Cloudflare bot gate, so live GraphQL queries work from the terminal like a browser.

Choose this when direct HTTP to the hub gateway would otherwise 403.

Commands

account

Your RapidAPI account (requires login)

rapidapi-pp-cli account notifications - List your notifications
rapidapi-pp-cli account saved - List APIs you saved as favorites
rapidapi-pp-cli account subscriptions - List your API subscriptions with plan details and status
rapidapi-pp-cli account whoami - Show the active logged-in user, their entities, and tenant
rapidapi-pp-cli account workspace - Show your workspace: owned APIs, subscribed APIs, metrics

apis

Inspect individual marketplace APIs

rapidapi-pp-cli apis - Show a single API's full detail: endpoints, versions, billing plans, rating, owner

collections

Browse curated API collections

rapidapi-pp-cli collections list - List curated collections (Recommended, Popular, Free, AI-based)
rapidapi-pp-cli collections show - Show a collection's detail and its APIs

marketplace

Search the RapidAPI marketplace

rapidapi-pp-cli marketplace - Search APIs across the marketplace with filters, facets, scores, and pagination

metrics

Hub-wide marketplace statistics

rapidapi-pp-cli metrics - Show public marketplace metrics: total APIs, users, consumers, API traffic

users

Inspect marketplace users

rapidapi-pp-cli users - Show a user profile and their published APIs

Self-learning loop

This CLI caches per-question discovery so repeat queries skip the walk and structurally similar queries get answered via entity substitution. The loop also self-captures: every invocation is journaled locally, and failed-flag corrections plus fresh teaches surface as candidates on the next recall for confirm/reject judgment. Agents call recall before discovery and fire teach & after answering. See the ## Automatic learning section in SKILL.md for the full protocol.

rapidapi-pp-cli recall <query> - Look up cached resources for a query before running discovery
rapidapi-pp-cli teach - Record a query -> resource mapping (silent on success, safe to background with &)
rapidapi-pp-cli learnings list - Inspect taught rows
rapidapi-pp-cli learnings forget <query> - Undo a teach
rapidapi-pp-cli learnings candidates - List auto-captured candidates awaiting confirm/reject
rapidapi-pp-cli learnings stats - Local loop metrics: recall hit rate, teach-to-reuse, playbook resolution, candidate counts
rapidapi-pp-cli teach-pattern - Install a query/resource template up front
rapidapi-pp-cli teach-lookup - Add an entity mapping (e.g. country code, team alias) for pattern substitution

Pass --no-learn or set RAPIDAPI_NO_LEARN=true to disable the loop for deterministic flows.

The local store's schema version stamp is one-way: once this version of rapidapi-pp-cli opens the database, older binaries refuse it with a version error — upgrade the binary rather than downgrading.

Cookbook

Real-world recipes (flags verified against --help):

# Find free weather APIs ranked by popularity
rapidapi-pp-cli marketplace search weather --category Weather --limit 10 --json --select id,name,score

# Quick search without filters, then cache results for offline use
rapidapi-pp-cli search --term linkedin --limit 5

# Explore a curated collection
rapidapi-pp-cli collections show recommended-apis --json

# Get the full spec of a specific API (endpoints, plans, rating)
rapidapi-pp-cli apis meteostat/meteostat --with-endpoints

# Hub-wide pulse check
rapidapi-pp-cli metrics --from 2026-01-01 --to 2026-12-31 --json

# Your subscriptions and notifications (needs session cookie)
rapidapi-pp-cli account subscriptions --status ACTIVE
rapidapi-pp-cli account notifications --limit 5

# Traffic analytics with local aggregation
rapidapi-pp-cli account analytics --from 2026-08-01 --to 2026-08-28
rapidapi-pp-cli trends --days 14

# Export your cached API research to CSV for a spreadsheet
rapidapi-pp-cli export --resource api --format csv --out apis.csv

# CI-friendly health gate
rapidapi-pp-cli doctor --fail-on error

Output Formats

# Human-readable table (default in terminal, JSON when piped)
rapidapi-pp-cli categories --limit 10

# JSON for scripting and agents
rapidapi-pp-cli categories --limit 10 --json
# Filter to specific fields
rapidapi-pp-cli categories --limit 10 --json --select id,name,weight

# Dry run — show the request without sending
rapidapi-pp-cli categories --limit 10 --dry-run

# Agent mode — JSON + compact + no prompts in one flag
rapidapi-pp-cli categories --limit 10 --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select <field>[,<field>...] returns only fields you need
Previewable - --dry-run shows the request without sending
Explicit retries - add --idempotent to create retries when a no-op success is acceptable
Explicit confirmation - --agent does not imply --yes; pass --yes separately only after the target, arguments, and side effects are clear
Piped input - write commands can accept structured input when their help lists --stdin
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

rapidapi-pp-cli doctor

Checks config, auth, cache freshness, and gateway reachability. Use --fail-on error to exit non-zero on errors (CI-friendly), or --fail-on stale to also fail when the local cache is stale.

Verifies configuration, credentials, and connectivity to the API.

Configuration

Run rapidapi-pp-cli doctor to see the resolved config, data, state, and cache directories. The platform-default config path is ~/.config/rapidapi-pp-cli/config.toml; --home, RAPIDAPI_HOME, and per-kind env vars can relocate it.

Static request headers can be configured under headers; per-command header overrides take precedence.

Environment variables:

Name	Kind	Required	Description
`RAPIDAPI_CSRF_TOKEN`	per_call	Yes	Set to your API credential.
`RAPIDAPI_COOKIE`	per_call	Yes	Set to your API credential.
`RAPIDAPI_CLEARANCE`	per_call	Yes	Set to your API credential.

agentcookie (optional)

If you use agentcookie to sync secrets across machines, this CLI auto-adopts agentcookie-managed credentials with no extra setup. When the daemon writes to this CLI's config, rapidapi-pp-cli doctor reports agentcookie: detected and auth-status labels the source as agentcookie. Skip this section if you don't use agentcookie - the CLI works the same as any other.

Troubleshooting

Authentication errors (exit code 4)

Run rapidapi-pp-cli doctor to check credentials
Verify the environment variable is set: echo $RAPIDAPI_CSRF_TOKEN Not found errors (exit code 3)
Check the resource ID is correct
Run the list command to see available items

Generated by CLI Printing Press