APIClaw — Amazon Data API for AI Agents
resmiReal-time Amazon data API built for AI agents. 200M+ products, 1B+ reviews, live BSR, pricing, and competitor data as clean JSON. 10 agent skills for market research, competitor monitoring, pricing, listing audits, and more. 1,000 free credits.
APIClaw Skills
The data infrastructure built for agents.
Currently powering Amazon commerce with 200M+ products, 1B+ reviews, and real-time signals.
Website • Get API Key • Discord • Quick Start • API Reference
What is APIClaw?
APIClaw is the data infrastructure built for agents. Not a scraping API. Not a human dashboard. A purpose-built data layer that gives your AI agents direct access to Amazon commerce signals — 200M+ indexed products, 2+ years of history, and 1B+ reviews pre-processed into structured insights. Clean JSON, real-time, agent-ready.
https://github.com/user-attachments/assets/305a161b-7a53-49b8-afdc-4469a4fbf361
Skills Overview
This repo contains 10 agent skills organized in two tiers:
🏗️ Foundation — data access and full-spectrum analysis:
| Skill | What It Does | Input | Output | Key Advantage |
|---|---|---|---|---|
📦 apiclaw/ | Direct access to all 11 API endpoints — categories, markets, products, competitors, realtime, reviews, price bands, brands, history | Keyword, category, ASIN, or brand | Raw API data with field mapping and quirk documentation | Complete API reference — every other skill builds on this |
🎯 amazon-analysis/ | 13 built-in selection modes + market research, competitor analysis, ASIN evaluation, pricing, category research | Keyword/category/ASIN + intent | Analysis findings, top products, ASIN deep dives, confidence-tagged insights | Composite commands (report, opportunity) run multi-endpoint pipelines in one shot |
⚡ Specialized — purpose-built for specific workflows:
| Skill | What It Does | Input | Output | Key Advantage |
|---|---|---|---|---|
⚔️ amazon-competitor-intelligence-monitor/ | Deep competitor intelligence — Full Scan or Quick Check with tiered alerts | Keyword or ASIN(s), optionally your ASIN + competitor ASINs | Competitor matrix, brand ranking, price map, 30-day trends, scores (1-100), tiered alerts | Dual-mode (Full ~28-35 credits, Quick ~5-10) with three-tier alert system |
📡 amazon-daily-market-radar/ | Automated daily monitoring — price changes, new competitors, BSR movements, review spikes | Your ASINs (1-10) + keyword | RED/YELLOW/GREEN alerts, KPI dashboard, competitor movement, action items | Set-and-forget with signal validation (7+ day trends vs single-day spikes) |
✅ amazon-listing-audit-pro/ | 8-dimension listing health check with optimization recommendations | Your ASIN + keyword | Score (X/100, A-F), 8-dimension scorecard, keyword gaps, priority fix list | Actionable rewrites using high-frequency review language; bulk audit support |
🚪 amazon-market-entry-analyzer/ | One-click market viability — discovers sub-markets, scores (1-100), delivers GO/CAUTION/AVOID | Keyword or category path | Sub-market landscape, verdict, market overview, brand landscape, entry strategy | Auto sub-market discovery with dual-level CR10 check |
📈 amazon-market-trend-scanner/ | Category landscape scanning — trending subcategories, emerging niches, market shifts | 1+ category paths or keywords | Trend dashboard, Hot Categories TOP 5, new entrant scan, risk alerts | Category-level trend analysis across ALL subcategories |
💎 amazon-opportunity-discoverer/ | Profile-driven opportunity scanner — auto-selects strategies, validates with real-time data, 7-dimension scoring | Budget + experience level + keyword/category | Top 10 opportunities (S/A/B/C), detailed top 3 analysis, risk alerts | Profile-driven strategy auto-selection + Quick-Scan (~10 credits) |
💰 amazon-pricing-command-center/ | Data-driven pricing signals — auto-detects leaf category, analyzes pricing landscape | One or more ASINs | RAISE/HOLD/LOWER signal, price band heatmap, competitor price map, BuyBox analysis | ASIN-only input (no keyword needed), Sales/Competition Ratio |
💬 amazon-review-intelligence-extractor/ | Deep consumer insights from 1B+ pre-analyzed reviews across 11 dimensions | Single ASIN, multiple ASINs, or category keyword | Pain points, buying factors, user profiles, usage patterns, differentiation roadmap | 1B+ pre-analyzed reviews (95% token savings), 11 dimensions |
Quick Start
1. Install the Skills
npx skills add SerendipityOneInc/APIClaw-Skills
You'll be prompted to select which skills to install:
🏗️ Foundation:
- APIClaw — Amazon Commerce Data, 11 Endpoints
- Amazon Analysis — Full-Spectrum Research & Seller Intelligence
⚡ Specialized:
- Amazon Competitor Intelligence Monitor — Dual-mode competitive intelligence with tiered alerts
- Amazon Daily Market Radar — Automated Monitoring & Alerts
- Amazon Listing Audit Pro — 8-Dimension Health Check
- Amazon Market Entry Analyzer — GO/CAUTION/AVOID Verdicts
- Amazon Market Trend Scanner — Daily Category Radar
- Amazon Opportunity Discoverer — Niche Scanner & Scoring
- Amazon Pricing Command Center — RAISE/HOLD/LOWER Signals
- Amazon Review Intelligence Extractor — Consumer Insights from 1B+ Reviews
Or clone manually:
git clone https://github.com/SerendipityOneInc/APIClaw-Skills.git
2. Set Your API Key
export APICLAW_API_KEY='hms_live_xxx' # Get yours free at apiclaw.io/en/api-keys
🎁 Free tier: 1,000 credits on signup. 1 credit = 1 API call. No credit card required.
3. Try It
Ask your AI agent:
"Analyze the competitive landscape for wireless earbuds under $50 on Amazon US"
Or use the CLI directly:
python amazon-analysis/scripts/apiclaw.py products --keyword "wireless earbuds" --mode competitive_landscape
API Endpoints
Base URL: https://api.apiclaw.io/openapi/v2
Auth: Authorization: Bearer $APICLAW_API_KEY
Method: All endpoints use POST with JSON body
| Endpoint | Description | Example Use Case |
|---|---|---|
🔍 products/search | Product search with 13 preset modes, 20+ filters | "Find running shoes under $80 with 4+ stars" |
📊 markets/search | Market-level metrics — concentration, brand share, pricing | "How competitive is the yoga mat market?" |
🏷️ products/competitors | Competitor discovery by keyword, brand, or ASIN | "Who are the top sellers in this niche?" |
⚡ realtime/product | Real-time product details — reviews, features, variants | "Get current details for ASIN B0D5CRV4KL" |
💬 reviews/analysis | AI-powered review insights — sentiment, pain points | "What do customers love/hate about this product?" |
📁 categories | Amazon category tree navigation | "Show subcategories under Electronics" |
📈 products/price-band-overview | Price band summary with best opportunity band | "What's the best price range for yoga mats?" |
📊 products/price-band-detail | Full 5-band price distribution analysis | "Show detailed price band breakdown for wireless earbuds" |
🏢 products/brand-overview | Top-brand concentration metrics (CR10) | "How concentrated is the brand landscape?" |
🏷️ products/brand-detail | Per-brand breakdown with top products | "Which brands dominate this category?" |
📅 products/history | Historical daily snapshots for ASINs | "Show price and BSR history for this ASIN" |
13 Product Search Modes
The products/search endpoint supports 13 preset modes for different research strategies:
| Mode | Strategy | Target |
|---|---|---|
fast-movers | High sales velocity | Quick revenue |
emerging | Rising trends, low saturation | Early movers |
long-tail | Niche keywords, steady demand | Sustainable income |
underserved | High demand, few sellers | Market gaps |
new-release | Recently launched products | Trending items |
fbm-friendly | Suitable for merchant fulfillment | Low-investment start |
low-price | Budget-friendly products | Volume strategy |
single-variant | Simple listings, no variants | Easy management |
high-demand-low-barrier | High sales, low review barrier | Scalable entry |
broad-catalog | Wide product range analysis | Category overview |
selective-catalog | Curated high-quality picks | Premium selection |
speculative | High-risk, high-reward opportunities | Aggressive strategy |
top-bsr | Best Seller Rank leaders | Market leaders |
Project Structure
├── apiclaw/ # Data layer skill (lightweight)
│ ├── SKILL.md # 11 endpoints, quick start
│ └── references/
│ └── openapi-reference.md # API field reference
│
├── amazon-analysis/ # Deep analysis skill
│ ├── SKILL.md # Intent routing, workflows, evaluation criteria
│ ├── references/
│ │ ├── reference.md # Full API reference
│ │ ├── execution-guide.md # Step-by-step execution playbook
│ │ ├── scenarios-composite.md # Comprehensive recommendations
│ │ ├── scenarios-eval.md # Product evaluation, risk, reviews
│ │ ├── scenarios-pricing.md # Pricing strategy
│ │ ├── scenarios-ops.md # Market monitoring, alerts
│ │ ├── scenarios-expand.md # Expansion, trends
│ │ └── scenarios-listing.md # Listing writing, optimization
│ └── scripts/
│ └── apiclaw.py # CLI — 8 subcommands, 13 preset modes
│
├── amazon-competitor-intelligence-monitor/ # Competitor intelligence & monitoring
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-daily-market-radar/ # Daily market pulse & anomaly detection
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-listing-audit-pro/ # Listing quality audit & optimization
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-market-entry-analyzer/ # Market viability assessment
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-opportunity-discoverer/ # Niche & opportunity identification
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-market-trend-scanner/ # Category landscape scanning & trend discovery
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-pricing-command-center/ # Pricing strategy & competitive signals
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── amazon-review-intelligence-extractor/ # Review intelligence & insight extraction
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── apiclaw.py
│
├── scoring-methodology.md # Unified quality scoring framework
├── CHANGELOG.md
└── README.md
Requirements
- Python 3.8+ (stdlib only, zero pip dependencies)
- APIClaw API Key (get one free)
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Community
- 💬 Discord — Chat, get help, share what you're building
- 🐛 Issues — Bug reports and feature requests
- 📖 API Docs — Full API documentation
License
İlgili Sunucular
Scout Monitoring MCP
sponsorPut performance and error data directly in the hands of your AI assistant.
Alpha Vantage MCP Server
sponsorAccess financial market data: realtime & historical stock, ETF, options, forex, crypto, commodities, fundamentals, technical indicators, & more
Prompts MCP Server
An MCP server for managing and serving prompts from markdown files with YAML frontmatter support.
Remote MCP Server on Cloudflare
An MCP server deployable on Cloudflare Workers with OAuth login support.
MCP Experiments
An experimental dotnet MCP server that returns the current time, based on Laurent Kempé's tutorial.
Remote MCP Server (Authless)
An example of a remote MCP server without authentication, deployable on Cloudflare Workers.
MCPunk
Explore and understand codebases through conversation by breaking files into logical chunks for searching and querying without embeddings.
BCMS MCP
Give me a one - two sentence description of the BCMS MCP # MCP The BCMS Model Context Protocol (MCP) integration enables AI assistants like Claude, Cursor, and other MCP-compatible tools to interact directly with your BCMS content. This allows you to create, read, and update content entries, manage media files, and explore your content structure—all through natural language conversations with AI. ## What is MCP? The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard developed by Anthropic that allows AI applications to securely connect to external data sources and tools. With BCMS MCP support, you can leverage AI assistants to: - Query and explore your content structure - Create new content entries with AI-generated content - Update existing entries - Manage your media library - Get intelligent suggestions based on your content model --- ## Getting Started ### Prerequisites 1. A BCMS account with an active instance 2. An MCP key with appropriate permissions 3. An MCP-compatible client (Claude Desktop, Cursor, or any MCP client) ### Step 1: Create an MCP Key 1. Navigate to your BCMS dashboard 2. Go to Settings → MCP 3. Click Create MCP Key 4. Configure the permissions for templates you want the AI to access:GET: Read entries 5. POST: Create entries 6. PUT: Update entries 7. DELETE: Delete entries Note: Right now, MCP only supports creating, reading and updating content. ### Step 2: Configure Your MCP Client You can find full instructions for integrating BCMS with your AI tools right inside BCMS, on the MCP page. But in general, installing BCMS MCP works in a standard way: ``` { "mcpServers": { "bcms": { "url": "https://app.thebcms.com/api/v3/mcp?mcpKey=YOUR_MCP_KEY" } } } ``` ## Available Tools Once connected, your AI assistant will have access to the following tools based on your MCP key permissions: ### Content Discovery #### list_templates_and_entries Lists all templates and their entries that you have access to. This is typically the first tool to call when exploring your BCMS content. Returns: - Template IDs, names, and slugs - Entry IDs with titles and slugs for each language Example prompt: "Show me all the templates and entries in my BCMS" --- ### Entry Management #### list_entries_for_{templateId} Retrieves all entries for a specific template with full content data. A separate tool is generated for each template you have access to. Returns: - Complete entry data including all meta fields - Content in all configured languages - Entry statuses Example prompt: "List all blog posts from my Blog template" --- #### create_entry_for_{templateId} Creates a new entry for a specific template. The input schema is dynamically generated based on your template's field structure. Input: - statuses: Array of status assignments per language - meta: Array of metadata for each language (title, slug, custom fields) - content: Array of content nodes for each language Example prompt: "Create a new blog post titled 'Getting Started with BCMS' with a brief introduction paragraph" --- #### update_entry_for_{templateId} Updates an existing entry for a specific language. Input: - entryId: The ID of the entry to update - lng: Language code (e.g., "en") - status: Optional status ID - meta: Updated metadata - content: Updated content nodes Example prompt: "Update the introduction paragraph of my 'Getting Started' blog post" --- ### Media Management #### list_all_media Lists all media files in your media library. Returns: - Media IDs, names, and types - File metadata (size, dimensions for images) - Parent directory information Example prompt: "Show me all images in my media library" --- #### list_media_dirs Lists the directory structure of your media library. Returns: - Hierarchical directory structure - Directory IDs and names Example prompt: "Show me the folder structure of my media library" --- #### create-media-directory Creates a new directory in your media library. Input: - name: Name of the directory - parentId: Optional parent directory ID (root if not specified) Example prompt: "Create a new folder called 'Blog Images' in my media library" --- #### request-upload-media-url Returns a URL you use to upload a file (for example via POST with multipart form data), which avoids pushing large binaries through the MCP tool payload. You still need a valid file name and MIME type when uploading, as described in the tool response. Availability: Only when the MCP key has Can mutate media enabled. Example prompt: “Give me an upload URL for a new hero image, then tell me how to upload it.” Input: - fileName: Name of the file with extension - fileData: Base64-encoded file data (with data URI prefix) - parentId: Optional parent directory ID Example prompt: "Upload this image to my Blog Images folder" --- ### Linking Tools #### get_entry_pointer_link Generates an internal BCMS link to an entry for use in content. Input: - entryId: The ID of the entry to link to Returns: - Internal link format: entry:{entryId}@*_{templateId}:entry Example prompt: "Get me the internal link for the 'About Us' page entry" --- #### get_media_pointer_link Generates an internal BCMS link to a media item for use in content. Input: - mediaId: The ID of the media item Returns: - Internal link format: media:{mediaId}@*_@*_:entry Example prompt: "Get the link for the hero image so I can use it in my blog post" --- ## Content Structure ### Entry Content Nodes When creating or updating entries, content is structured as an array of nodes. Supported node types include: Type Description paragraph Standard text paragraph heading Heading (h1-h6) bulletList Unordered list orderedList Numbered list listItem List item codeBlock Code block with syntax highlighting blockquote Quote block image Image node widget Custom widget with props ### Example Content Structure ``` { "content": [ { "lng": "en", "nodes": [ { "type": "heading", "attrs": { "level": 1 }, "content": [ { "type": "text", "text": "Welcome to BCMS" } ] }, { "type": "paragraph", "content": [ { "type": "text", "text": "This is your first paragraph." } ] } ] } ] } ``` ## Security & Permissions ### MCP Key Scopes Your MCP key controls what the AI can access: - Template Access: Only templates explicitly granted in the MCP key are visible - Operation Permissions: Each template can have independent GET/POST/PUT/DELETE permissions - Media Access: Media operations are controlled separately ### Best Practices 1. Principle of Least Privilege: Only grant the permissions needed for your use case 2. Separate Keys: Create different MCP keys for different purposes or team members 3. Regular Rotation: Periodically rotate your MCP keys ## Use Cases ### Content Creation Workflows Blog Post Creation "Create a new blog post about the benefits of headless CMS. Include an introduction, three main benefits with explanations, and a conclusion. Use the Blog template." Product Updates "Update the price field for all products in the Electronics category to apply a 10% discount" ### Content Exploration Content Audit "List all blog posts that don't have a featured image set" Translation Status "Show me which entries are missing German translations" ### Media Organization Library Cleanup "Show me all unused images in the media library" Folder Setup "Create folder structure for: Products > Categories > Electronics, Clothing, Home" ## Troubleshooting ### Common Issues #### "MCP key not found" - Verify your MCP key format: keyId.keySecret.instanceId - Ensure the MCP key hasn't been deleted or deactivated - Check that you're using the correct instance #### "MCP key does not have access to template" - Review your MCP key permissions in the dashboard - Ensure the required operation (GET/POST/PUT/DELETE) is enabled for the template #### Session Expired - MCP sessions may timeout after periods of inactivity - Simply start a new conversation to establish a fresh session ### Getting Help - Documentation: [thebcms.com/docs](https://thebcms.com/docs) - Support: [[email protected]](mailto:[email protected]) - Community: [Join BCMS Discord](https://discord.com/invite/SYBY89ccaR) for community support ## Technical Reference ### Endpoint POST https://app.thebcms.com/api/v3/mcp?mcpKey={MCP_KEY} ### Transport BCMS MCP uses the Streamable HTTP transport with session management. Sessions are maintained via the mcp-session-id header. ### Response Format All tools return structured JSON responses conforming to the MCP specification with: - content: Array of content blocks - structuredContent: Typed response data ## Rate Limits MCP requests are subject to the same rate limits as API requests: - Requests are tracked per MCP key - Contact support if you need higher limits for production workloads
Agent Forge
A platform for creating and managing AI agents with specific personalities and simulating their responses. Requires a DeepSeek API key.
Scientific Computation MCP
Provides tools for scientific computation, including tensor storage, linear algebra, vector calculus, and visualization.
Lean LSP
Interact with the Lean theorem prover via the Language Server Protocol (LSP), enabling LLM agents to understand, analyze, and modify Lean projects.
Tailkits UI
Tailwind Components with Native MCP Support