keepa-adapter
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KEEPA_API_KEY | Yes | Your Keepa API key | |
| KEEPA_DB_PATH | No | Path to SQLite database | ~/.keepa-adapter/keepa.db |
| KEEPA_DEFAULT_DOMAIN | No | Default Amazon marketplace (e.g., uk, de, jp, ca, au) | com |
| KEEPA_TOKENS_PER_MINUTE | No | Token refill rate for your Keepa plan | 5 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| keepa_get_productA | Fetch current product data for 1-100 ASINs from Keepa. Returns title, brand, prices, BSR, rating, buy box, images, features, variations. |
| keepa_get_price_historyC | Get price, rank, rating, and review history for ASINs. Returns time series data. |
| keepa_get_buy_boxA | Get buy box ownership info including current seller, FBA status, and offers for ASINs. |
| keepa_get_variationsB | Get variation family tree for an ASIN including parent/child relationships and attributes. |
| keepa_check_tokensA | Check remaining Keepa API tokens and refresh rate. |
| keepa_track_asinsA | Add ASINs to the monitoring list for daily snapshot collection and change detection. |
| keepa_take_snapshotA | Fetch and store a snapshot for tracked ASINs. Returns any detected changes vs the previous snapshot. |
| keepa_get_changesA | Query detected changes for ASINs over a given period. |
| keepa_analyze_bsr_trendB | Analyze BSR trend for ASINs over a period. Flags deterioration patterns. |
| keepa_check_variationsB | Check variation family for orphans, attribute drift, and child changes. |
| keepa_add_promoB | Register a promotional event for an ASIN (coupon, deal, Lightning Deal, etc.). |
| keepa_list_promosC | List promotional events for an ASIN or all tracked ASINs. |
| keepa_analyze_promo_impactA | Overlay a promo with rank/price data to measure lift. Compares before, during, and after the promo period. |
| keepa_get_sales_historyA | Get monthly sales volume time series for ASINs. Shows how many units are sold per month over time. |
| keepa_get_dealsA | Get coupon history, active promotions, and lightning deal data for ASINs. |
| keepa_get_seller_statsA | Get buy box statistics per seller for ASINs, including win percentage, average price, and FBA status. |
| keepa_get_best_sellersB | Get the best seller ASIN list for a category. |
| keepa_get_categoryA | Look up category details including name, parent, children, and product count. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Each tool targets a distinct resource or action: product data, price history, buy box, variations, tracking, changes, analysis, promotions, sales, deals, seller stats, best sellers, and category. Overlapping concerns like get_product vs get_price_history and analyze_bsr_trend vs analyze_promo_impact are clearly differentiated by their descriptions.
All 18 tools follow a consistent 'keepa_<verb>_<noun>' snake_case pattern. Verbs (check, get, track, take, analyze, add, list) are used predictably, with no camelCase or mixed conventions.
18 tools is at the upper end of a reasonable scope for a comprehensive Keepa adapter. Each tool addresses a specific feature area, and though slightly above the typical 3-15 range, the breadth of the domain justifies the count.
The set covers core product data, price history, buy box, variations, sales history, best sellers, categories, tracking with snapshots and changes, and promotional analysis. Missing operations like untrack_asins or delete_promo are minor gaps; agents could work around them, but they prevent full lifecycle management.