{
  "markdown": "# ListingGood — AI Recommendation Engine (Skills + MCP)\n\n> **Make AI recommend your products.** ListingGood is the engine that helps Amazon's AI — Rufus, COSMO, and agentic shopping agents — find, trust, and recommend your listings. It does this through three things: **compliance**, **AI writing**, and **appeal rescue**.\n\n[![Website](https://img.shields.io/badge/website-listinggood.com-blue)](https://listinggood.com) [![MCP](https://img.shields.io/badge/MCP-server-green)](https://listinggood.com/developers) [![Free check](https://img.shields.io/badge/free%20check-no%20login-success)](https://listinggood.com/scan)\n\n---\n\n## Installation\n\nListingGood runs as a **hosted, remote Streamable HTTP MCP server** — there is nothing to install locally. Just point your MCP client at the endpoint with your API key.\n\n**Endpoint:**\n\n```\nhttps://listinggood.com/mcp?apikey=YOUR_API_KEY\n```\n\nGet your free API key at **[listinggood.com/developers](https://listinggood.com/developers)** (signup grants 10 permanent stars).\n\n### Claude Desktop / Cursor / VS Code / Windsurf / Cline\n\n```json\n{\n  \"mcpServers\": {\n    \"listinggood\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://listinggood.com/mcp?apikey=YOUR_API_KEY\"\n    }\n  }\n}\n```\n\n> No Docker build, no `npx` command, no local Python runtime — the API key is passed as a URL query parameter (`?apikey=...`) exactly as shown above.\n\n---\n\n## Why this exists\n\nAmazon's discovery front-door has moved to AI. A listing that is **not machine-readable and compliance-clean** is far less likely to be cited inside Rufus answers, COSMO-driven recommendations, or agentic buying flows. Traditional seller tools tell you *what to sell* — they don't tell you whether your listing will be *recommended*.\n\nListingGood closes that gap:\n\n- **Compliance pre-check** — flags risky claims and category issues *before* you publish (free, no login).\n- **AI readability** — scores how well Amazon's AI surfaces can parse and cite your listing.\n- **AI writing** — generates compliant titles, bullets, and descriptions.\n- **Appeal rescue** — drafts a Plan of Action (POA) when a listing is suppressed.\n\nThe combined result is an **AI Recommendation Readiness Score** = compliance × 0.55 + AI readability × 0.45.\n\n---\n\n## Available Tools\n\n### `ai_readiness_check`\nScore how likely Amazon's AI (Rufus, COSMO) is to recommend a listing. Returns a combined AI Recommendation Readiness Score with actionable fixes. **Free, no API key required.**\n\n### `agent_ready_check`\nScore whether a product listing is **Agent-Ready** for AI shopping agents (OpenAI ACP / Google UCP era). Platform-agnostic: Amazon, Shopify, Walmart, TikTok Shop or any storefront. Returns four dimensions — structured attributes, entity clarity, trust & compliance, agent actionability — plus ranked fixes. **Free, no API key required, runs fully locally in the MCP server (no credits).**\n\n### `compliance_check`\nFast pre-publish compliance gate: scans for red-line words and category risks before you generate or publish. **Free with API key.**\n\n### `compliance_scan`\nDeep, knowledge-base-driven compliance audit across prohibited terms, IP risk, category rules, and GPSR. Returns a written report. **2 credits.**\n\n### `generate_listing`\nGenerate optimized title + bullets + description for selected marketplaces. **1 credit per marketplace.**\n\n### `fill_from_sentence`\nTurn a one-sentence product description into structured listing fields. **Free with API key.**\n\n### `generate_poa`\nDraft a submission-ready Plan of Action from an Amazon violation or suspension notice. **4 credits.**\n\n### `analyze_review`\nAnalyze a negative review for root cause and a suggested response or POA angle. **2 credits.**\n\n---\n\n## What's in this repo\n\nThis repository bundles ListingGood's **agent skills** and **MCP server** config so AI agents and power users can call ListingGood programmatically:\n\n| Package | What it does |\n|---|---|\n| `listinggood-expert` | All-in-one Amazon listing expert: write · compliance pre-check · appeal rescue |\n| `listinggood-amazon-listing-optimizer` | High-conversion listing generation (title + bullets + description) |\n| `listinggood-amazon-compliance-auditor` | Compliance audit with Critical/Warning/Info grading |\n| `listinggood-deep-compliance` | Deep, knowledge-base-backed compliance report |\n| `listinggood-appeal-rescue` | POA drafting + negative-review root-cause analysis |\n| `listinggood-amazon-title-optimizer` | A9/A10 title optimization |\n| `listinggood-amazon-bullet-writer` | Benefit-led bullet points |\n| `listinggood-amazon-eu-localization` | EU marketplace (DE/ES/FR/IT) localization |\n| **MCP server** | 8 tools (free check, Agent-Ready score, deep scan, AI generation, POA, …) + vertical MCPs (Electronics / Toys / Beauty / Home) |\n\n---\n\n## Quick start\n\n1. Get a free API key at **[listinggood.com/developers](https://listinggood.com/developers)**.\n2. Add the server to your MCP client using the config block in [Installation](#installation).\n3. Restart your client. ListingGood's tools appear as available MCP tools.\n\n---\n\n## Try it now (no account)\n\nRun a free compliance + AI-readability check at **[listinggood.com/scan](https://listinggood.com/scan)** — paste your title and bullets, get a report in seconds.\n\n---\n\n## Links\n\n- Website & free check: https://listinggood.com\n- Developers / MCP config: https://listinggood.com/developers\n- Changelog: https://listinggood.com/changelog\n\n---\n\n*ListingGood AI Recommendation Engine — make AI recommend your products.*\n",
  "bytes": 5507,
  "sha": "8f36e02a12c1866ce9fd44b6eab4ff065de567849497447c360d0b398f791f41",
  "repo_slug": "ryanyang828/listinggood-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ryanyang828_listinggood_521a78db/readme"
}