semanticapi-cli 0.1.4

CLI for Semantic API — discover and query 700+ APIs with natural language

Semantic API CLI

Query 700+ APIs with natural language from your terminal. Zero dependencies.

pip install semanticapi-cli

✨ Auto-Discover & Auto-Heal

Auto-Discover: Ask for any API — even ones not in the catalog. Semantic API automatically finds the docs, generates a provider config, and returns endpoint details. No manual setup.

semanticapi query "send a message with Discord"
# → Auto-discovers Discord API, returns endpoint + auth details

Auto-Heal: If an API's config goes stale (endpoints change, versions update), Semantic API detects the failure, re-discovers from current docs, and retries — all in a single request.

Quick Start

# Save your API key
semanticapi config set-key sapi_your_key

# Query any API
semanticapi query "send an SMS via Twilio"

# Search for capabilities
semanticapi search "weather forecast"

# Browse the catalog
semanticapi catalog list --search payments
semanticapi catalog stats

# Pre-check what you'll need (free, no LLM cost)
semanticapi preflight "send an email"

# Discover a provider
semanticapi discover stripe

# Batch queries
semanticapi batch "send email" "upload file" "translate text"

Commands

Command	Description
query	Natural language API query (with auto-discover)
search	Search for API capabilities
batch	Multiple queries in one call
preflight	Pre-check (free, identifies needed auth)
discover	Look up a provider by name
discover-url	Discover provider from docs URL
catalog list	Browse the provider catalog
catalog stats	Show catalog statistics
status	Show config and API health
config	Manage API key and settings

Authentication

API key priority (first found wins):

1. --key sapi_xxx flag
2. SEMANTICAPI_KEY environment variable
3. ~/.semanticapi/config.json (saved via config set-key)

Get your key at semanticapi.dev.

Output Modes

# Pretty-printed (default)
semanticapi query "get weather"

# Raw JSON (for piping)
semanticapi --raw query "get weather"

# Minimal output
semanticapi --quiet query "get weather"

Exit Codes

Code	Meaning
0	Success
1	Error
2	Auth required

What You Get Back

Every query returns:

• Provider and endpoint details
• Code snippets (curl + Python) ready to copy-paste
• Auth requirements and setup instructions
• Alternative providers ranked by relevance

Related

• Semantic API — The API
• MCP Server — For Claude Desktop / ChatGPT
• Agent Skill — For autonomous agents
• Open Source Engine — AGPL-3.0

License

MIT