kc Keepa CLI Agent-first product research
JSON, stdio, MCP, zread, fixtures

Keepa data, shaped for agents.

A token-aware Keepa API CLI for product research, category discovery, local reports, cassette promotion, and MCP-native automation. Built to keep raw evidence auditable while giving agents compact, structured views first.

Read the README Open zread wiki MCP architecture
MCP resources research_graph risk_taxonomy offline-first
Start here

One command surface for humans and agents.

# Human-readable CLI
kc --json doctor
kc --json products get B0D8W1YVBX --domain US --full --agent-view --view summary

# MCP JSON-RPC over stdio
'{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"toolset":"research"}}' | kc --mcp
'{"jsonrpc":"2.0","id":2,"method":"resources/templates/list","params":{}}' | kc --mcp

# Local graph report
kc --json research-graph merge category.json compare.json seller.json --root agent_selection_research --out graph.json
kc --json reports build --input graph.json --format markdown --out report.md
Documentation

Stable entry points.

Use Pages for durable links, zread for architecture reading, and MCP resources for agent-readable contracts.

Wiki

zread public wiki

Readable generated architecture documentation for onboarding and design review.

Guide

README

Install, configure token, run TUI, use JSON, stdio, MCP, and local reports.

Contract

Agent contract

Stable envelopes, Agent views, resources, workflow plans, cache, and budget ledgers.

Schema

Product Agent schema

Generated JSON schema for validating product research views and downstream pipelines.

MCP

MCP architecture

Toolsets, prompts, session cache, resources, graph merge, and safety boundaries.

Agent resources

Audit by resource, not by guesswork.

Agents can start from a policy, inspect a cached research result, or load a research graph by root.

Policy

keepa://context/policy

Offline-first defaults, allowed roots, tool gating, and live Keepa safety posture.

Cache

keepa://research/{cache_key}

Session result audit with evidence index, provenance, budget ledger, and graph summaries.

Graph

keepa://graphs/{root}

Research graph lookup across session cache and local fixtures for source auditing.