给卖家的入口
想让产品被 AI 推荐?不用看文档
贴上 ASIN 或 Listing 文案,30 秒拿到亚马逊 / TikTok Shop / Temu / SHEIN 四个平台的分数、缺口,以及今天该改的 3 件事。免费,不用注册。
免费诊断我的产品 → 写 Listing
下面是开发者文档(MCP / API)。工程师请继续往下:跳到文档 ↓

ListingGood Developers

Make AI recommend your products — connect ListingGood's real backend (compliance knowledge base + generation engine + usage-based billing) to any AI workspace that supports MCP or REST.

Get API Key → Connect in 1 minute

What you can build

ListingGood exposes two integration surfaces that share the same backend:

1 · MCP Connector (recommended)

A remote MCP server (streamable HTTP). Paste one URL with your API key into any MCP client — Claude Desktop, Cursor, WorkBuddy, or your own agent — and call 7 tools with zero local install.

2 · REST API

The same backend behind an OpenAPI-style REST interface. Authenticate with your API key and call endpoints directly from your own services, scripts, or backend jobs.

Both surfaces share the same metering. Free tools (compliance check, AI-readiness, visibility diagnosis) never consume credits. Paid tools are metered in credits (1 credit = $0.10); your monthly plan grants a fixed allowance that resets every month.

① Connection URL

Configure this URL in your MCP client and replace YOUR_KEY with your own ListingGood API key. No local install, no ops.

https://listinggood.cn/mcp?apikey=YOUR_KEY

Need a key? Log in and copy it from the Get API Key section below — the config cards will auto-fill.

② My connector config (auto-filled after login)

…

③ Tool list (7)

ToolBackendBillingDescription
agent_ready_checklocal rulesFreeAgent-Ready score for any storefront (Amazon / Shopify / Walmart / TikTok) — structured attributes, entity clarity, trust & compliance, agent actionability. Runs fully local: no API key, no credits.
ai_readiness_check/api/free-checkFreeAI recommendation readiness check — compliance health + AI readability. Works without a key.
compliance_check/api/compliance-checkFreeQuick pre-generation compliance check (banned words / category risk).
compliance_scan/api/scan/deepDeep compliance scan, knowledge-base-driven risk report.
generate_poa/api/appeal/poaGenerate a submit-ready POA appeal letter.
analyze_review/api/appeal/reviewNegative-review root cause + response suggestions.
fill_from_sentence/api/fill-from-sentenceFreeTurn one sentence into structured form fields.
generate_listing/api/generateGenerate high-converting multi-marketplace listings.
localize_listing/api/localizeFreeLocalize an existing listing into another marketplace's language (16 markets).
profit_calculatorlocal rulesFreeUnit economics per marketplace — referral fee, FBA fee, net margin. Runs fully local.
image_compliance_checklocal rulesFreeAmazon image-rule check (white background, min pixels, text ratio, watermarks). Local rules, lightweight.
ip_infringement_check/api/ipcheck/searchAppearance / design-patent infringement self-check on a product image — returns the risk level plus the closest design patents. Monthly allowance applies (Pro 1/month, Team 3/month).

Credits are an internal unit (1 credit = $0.10) used to meter paid tools. Your monthly plan grants a fixed credit allowance — credits are not sold separately. Free tools never consume credits.

④ Connection example (Python)

from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async with streamablehttp_client(
    "https://listinggood.cn/mcp?apikey=YOUR_KEY") as (r, w, _):
    async with ClientSession(r, w) as s:
        await s.initialize()
        res = await s.call_tool("ai_readiness_check",
                                {"text": "wireless earbuds", "marketplace": "US"})
        print(res)

Vertical MCPs (category-specific lead-gen)

Beyond the general connector, we ship narrow vertical MCPs that catch sellers at the exact pain point — fear of takedown / non-compliance — inside their AI agent workflow, then route them to ListingGood to pay for the deliverable.

Electronics Compliance MCP

Free diagnostic for electronics / electrical (CE / EMC / RoHS / WEEE / GPSR / FCC). 3 free tools; the per-SKU compliance evidence file package is generated on the site (paid).

https://listinggood.cn/mcp-electronics

No API key required — it's a free diagnostic front-end that returns a link to your paid /compliant file package.

API Reference (REST)

Authentication

Send your API key as a Bearer token in the request header, or as the apikey query parameter. The free hook /api/free-check requires no auth.

Authorization: Bearer YOUR_KEY
# or
GET /api/free-check?text=...&marketplace=US

Endpoints

MethodPathBillingDescription
POST/api/free-checkFreeAI readiness check. Body: {text, marketplace}.
POST/api/compliance-checkFreeQuick pre-check. Body: {title, bullets, marketplace}.
POST/api/scan/deepDeep scan. Body: {title, bullets, desc, marketplace, images?}.
POST/api/appeal/poaPOA letter. Body: {violation_type, marketplace, text}.
POST/api/appeal/reviewReview analysis. Body: {marketplace, review_text}.
POST/api/fill-from-sentenceFreeForm fill. Body: {sentence}.
POST/api/generateListing generation. Body: {cn_name, sku, marketplaces[], selling_points[]}.
POST/api/localizeFreeLocalization. Body: {text, target_lang, marketplace}.
POST/api/ipcheck/searchAppearance / design-patent image search. Body: {image_url | image_base64}. 10 credits per call.

Example request

curl -X POST https://listinggood.cn/api/scan/deep \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"French wool beret","bullets":["..."],"marketplace":"US"}'

On success the endpoint returns a JSON task; poll GET /api/task/<id> for the result. On insufficient credits it returns 402 with the cost.

Get your API Key

Use this key to authenticate the MCP connector or REST API. It is tied to your account and star balance.

Enterprise bulk integration / private deployment: email support@listinggood.cn.

Need help? Email support@listinggood.cn. For enterprise bulk integration / private deployment, contact us.