{
  "name": "China Marketing AI Agent Capabilities",
  "version": "2026-05-02",
  "updated_at": "2026-05-02T00:00:00+08:00",
  "homepage": "https://www.chinamarketing.ai/",
  "mcp_endpoint": "https://api.chinamarketing.ai/mcp",
  "api_catalog": "https://www.chinamarketing.ai/.well-known/api-catalog",
  "llms_txt": "https://www.chinamarketing.ai/llms.txt",
  "llms_full_txt": "https://www.chinamarketing.ai/llms-full.txt",
  "subject": "https://www.chinamarketing.ai/agents/capabilities",
  "capabilities": [
    {
      "capability_id": "brand_visibility_snapshot",
      "id": "brand_visibility_snapshot",
      "name": "Brand Visibility Snapshot",
      "version": "1.0.0",
      "stability": "beta",
      "schema_version": "1.0.0",
      "description": "Generate a China brand visibility snapshot with summary assessment, scored strengths and gaps, and priority actions.",
      "use_when": [
        "The user asks how visible a brand, hotel, destination, or consumer-facing business is in China.",
        "The user needs a quick China visibility or readiness snapshot.",
        "The user wants platform-level gaps across RED, Douyin, WeChat, search, and weekly signal environments."
      ],
      "do_not_use_when": [
        "The user needs a full manual audit or private account analytics.",
        "The user requires guaranteed live ranking data from every China platform.",
        "The request is primarily about non-China market visibility."
      ],
      "input_schema_url": "https://www.chinamarketing.ai/agents/schemas/brand-visibility.input.json",
      "output_schema_url": "https://www.chinamarketing.ai/agents/schemas/brand-visibility.output.json",
      "examples_url": "https://www.chinamarketing.ai/agents/examples/brand-visibility.json",
      "api_route": "https://api.chinamarketing.ai/v1/visibility/snapshot",
      "path": "https://api.chinamarketing.ai/v1/visibility/snapshot",
      "mcp_tool_name": "get_brand_visibility_snapshot",
      "docs_url": "https://www.chinamarketing.ai/agents/capabilities#brand-visibility-snapshot-capability",
      "service_doc_url": "https://www.chinamarketing.ai/agents/docs#brand-visibility-snapshot-capability",
      "pricing": {
        "currency": "USD",
        "amount": "0.63",
        "billing_unit": "request",
        "supports_x402": true,
        "supports_budget": true,
        "budget_behavior": {
          "below_minimum": "return_budget_too_low",
          "at_or_above_minimum": "execute_standard_analysis",
          "above_standard": "reserved_for_future_deeper_analysis",
          "refund_on_failure": false
        }
      },
      "response_features": [
        "score",
        "strengths",
        "gaps",
        "source_health",
        "confidence",
        "limitations",
        "recommended_next_actions"
      ],
      "api_paths": [
        "https://api.chinamarketing.ai/v1/china/trends",
        "https://api.chinamarketing.ai/v1/china/sentiment",
        "https://api.chinamarketing.ai/v1/signals/brands/:brand_slug/snapshot"
      ],
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "brand_name"
        ],
        "properties": {
          "brand_name": {
            "type": "string",
            "description": "Brand or entity to evaluate."
          },
          "category": {
            "type": "string",
            "description": "Commercial category or sector."
          },
          "market_scope": {
            "type": "string",
            "description": "China-facing scope, platform focus, or audience scope."
          },
          "notes": {
            "type": "string",
            "description": "Optional analyst notes or campaign context."
          }
        }
      },
      "output_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "summary",
          "score",
          "strengths",
          "gaps",
          "priority_actions",
          "source_health",
          "limitations",
          "recommended_next_actions"
        ],
        "properties": {
          "summary": {
            "type": "string"
          },
          "score": {
            "type": "number"
          },
          "strengths": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "gaps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "priority_actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "label",
                "kind"
              ],
              "properties": {
                "label": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "freshness": {
                  "type": "string"
                }
              }
            }
          },
          "source_health": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "status",
                "freshness",
                "confidence",
                "limitations"
              ],
              "properties": {
                "source": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "available",
                    "limited",
                    "unavailable",
                    "not_checked"
                  ]
                },
                "freshness": {
                  "type": "string",
                  "enum": [
                    "live",
                    "recent",
                    "stale",
                    "unknown"
                  ]
                },
                "confidence": {
                  "type": "string",
                  "enum": [
                    "high",
                    "medium",
                    "low"
                  ]
                },
                "limitations": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "limitations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "recommended_next_actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "confidence": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ]
          },
          "capability_id": {
            "type": "string"
          },
          "schema_version": {
            "type": "string"
          }
        }
      },
      "underlying_endpoints": [
        {
          "path": "https://api.chinamarketing.ai/v1/china/trends",
          "price_usd": "0.08",
          "description": "Structured China trend signals for AI agents and developer tools.",
          "ttl_seconds": 3600
        },
        {
          "path": "https://api.chinamarketing.ai/v1/china/sentiment",
          "price_usd": "0.15",
          "description": "Localized China sentiment and narrative analysis for brands, products, and destinations.",
          "ttl_seconds": 21600
        },
        {
          "path": "https://api.chinamarketing.ai/v1/signals/brands/:brand_slug/snapshot",
          "price_usd": "0.40",
          "description": "Derived weekly brand snapshot from the latest published China consumer signals release.",
          "ttl_seconds": 86400
        }
      ]
    },
    {
      "capability_id": "destination_demand_snapshot",
      "id": "destination_demand_snapshot",
      "name": "Destination Demand Snapshot",
      "version": "1.0.0",
      "stability": "beta",
      "schema_version": "1.0.0",
      "description": "Generate a China outbound destination demand snapshot with demand direction, notable signals, risk framing, and priority actions.",
      "use_when": [
        "The user asks whether China outbound demand is moving for a destination.",
        "The user needs directional demand context for destination, DMO, hospitality, or travel retail planning.",
        "The user wants flight and spend signals summarized into a decision-ready object."
      ],
      "do_not_use_when": [
        "The user needs booking, CRM, or private conversion data.",
        "The destination is outside the supported flight or spend evidence layer and a high-confidence answer is required.",
        "The user needs a full tourism forecast model rather than a fast signal snapshot."
      ],
      "input_schema_url": "https://www.chinamarketing.ai/agents/schemas/destination-demand.input.json",
      "output_schema_url": "https://www.chinamarketing.ai/agents/schemas/destination-demand.output.json",
      "examples_url": "https://www.chinamarketing.ai/agents/examples/destination-demand.json",
      "api_route": "https://api.chinamarketing.ai/v1/destination-demand/snapshot",
      "path": "https://api.chinamarketing.ai/v1/destination-demand/snapshot",
      "mcp_tool_name": "get_destination_demand_snapshot",
      "docs_url": "https://www.chinamarketing.ai/agents/capabilities#destination-demand-snapshot-capability",
      "service_doc_url": "https://www.chinamarketing.ai/agents/docs#destination-demand-snapshot-capability",
      "pricing": {
        "currency": "USD",
        "amount": "0.20",
        "billing_unit": "request",
        "supports_x402": true,
        "supports_budget": true,
        "budget_behavior": {
          "below_minimum": "return_budget_too_low",
          "at_or_above_minimum": "execute_standard_analysis",
          "above_standard": "reserved_for_future_deeper_analysis",
          "refund_on_failure": false
        }
      },
      "response_features": [
        "demand_direction",
        "notable_signals",
        "source_health",
        "confidence",
        "limitations",
        "recommended_next_actions"
      ],
      "api_paths": [
        "https://api.chinamarketing.ai/v1/market-data/flights/summary",
        "https://api.chinamarketing.ai/v1/market-data/spend/trends"
      ],
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "destination"
        ],
        "properties": {
          "destination": {
            "type": "string",
            "description": "Destination city, market, or country to evaluate."
          },
          "origin_market": {
            "type": "string",
            "description": "Origin market for the demand check.",
            "default": "China"
          },
          "travel_window": {
            "type": "string",
            "description": "Optional YYYY-MM or period label for the check."
          },
          "audience_segment": {
            "type": "string",
            "description": "Optional audience or traveler segment."
          }
        }
      },
      "output_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "summary",
          "demand_direction",
          "notable_signals",
          "opportunity_areas",
          "risks",
          "priority_actions",
          "source_health",
          "limitations",
          "recommended_next_actions"
        ],
        "properties": {
          "summary": {
            "type": "string"
          },
          "demand_direction": {
            "type": "string"
          },
          "notable_signals": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "opportunity_areas": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "risks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "priority_actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "source_health": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "status",
                "freshness",
                "confidence",
                "limitations"
              ],
              "properties": {
                "source": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "available",
                    "limited",
                    "unavailable",
                    "not_checked"
                  ]
                },
                "freshness": {
                  "type": "string",
                  "enum": [
                    "live",
                    "recent",
                    "stale",
                    "unknown"
                  ]
                },
                "confidence": {
                  "type": "string",
                  "enum": [
                    "high",
                    "medium",
                    "low"
                  ]
                },
                "limitations": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "limitations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "recommended_next_actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "confidence": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ]
          },
          "capability_id": {
            "type": "string"
          },
          "schema_version": {
            "type": "string"
          }
        }
      },
      "underlying_endpoints": [
        {
          "path": "https://api.chinamarketing.ai/v1/market-data/flights/summary",
          "price_usd": "0.10",
          "description": "Latest or month-specific destination flight-arrivals summary.",
          "ttl_seconds": 21600
        },
        {
          "path": "https://api.chinamarketing.ai/v1/market-data/spend/trends",
          "price_usd": "0.10",
          "description": "Destination spend trend pack for a country.",
          "ttl_seconds": 21600
        }
      ]
    },
    {
      "capability_id": "kol_shortlist",
      "id": "kol_shortlist",
      "name": "KOL Shortlist",
      "version": "1.0.0",
      "stability": "beta",
      "schema_version": "1.0.0",
      "description": "Generate a decision-ready China KOL shortlist with creator candidates, selection rationale, risk flags, and next steps.",
      "use_when": [
        "The user needs an initial China KOL or KOC shortlist for campaign planning.",
        "The user wants creator candidates with rationale, risk flags, and next steps.",
        "The user has a category or campaign goal and needs a fast platform-oriented starting set."
      ],
      "do_not_use_when": [
        "The user needs guaranteed current rates, availability, or contractual fit.",
        "The user requires private creator analytics or backend platform data.",
        "The user needs final media-buying recommendations without human review."
      ],
      "input_schema_url": "https://www.chinamarketing.ai/agents/schemas/kol-shortlist.input.json",
      "output_schema_url": "https://www.chinamarketing.ai/agents/schemas/kol-shortlist.output.json",
      "examples_url": "https://www.chinamarketing.ai/agents/examples/kol-shortlist.json",
      "api_route": "https://api.chinamarketing.ai/v1/kol/shortlist",
      "path": "https://api.chinamarketing.ai/v1/kol/shortlist",
      "mcp_tool_name": "get_kol_shortlist",
      "docs_url": "https://www.chinamarketing.ai/agents/capabilities#kol-shortlist-capability",
      "service_doc_url": "https://www.chinamarketing.ai/agents/docs#kol-shortlist-capability",
      "pricing": {
        "currency": "USD",
        "amount": "0.45",
        "billing_unit": "request",
        "supports_x402": true,
        "supports_budget": true,
        "budget_behavior": {
          "below_minimum": "return_budget_too_low",
          "at_or_above_minimum": "execute_standard_analysis",
          "above_standard": "reserved_for_future_deeper_analysis",
          "refund_on_failure": false
        }
      },
      "response_features": [
        "creators",
        "selection_rationale",
        "source_health",
        "confidence",
        "limitations",
        "recommended_next_actions"
      ],
      "api_paths": [
        "https://api.chinamarketing.ai/v1/china/kols"
      ],
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "brand_name",
          "category"
        ],
        "properties": {
          "brand_name": {
            "type": "string",
            "description": "Brand or campaign owner name."
          },
          "category": {
            "type": "string",
            "description": "Campaign or product category."
          },
          "campaign_goal": {
            "type": "string",
            "description": "Optional campaign objective."
          },
          "platform_focus": {
            "type": "array",
            "description": "Optional list of preferred platforms.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "output_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "summary",
          "creators",
          "selection_rationale",
          "risks",
          "next_steps",
          "source_health",
          "limitations",
          "recommended_next_actions"
        ],
        "properties": {
          "summary": {
            "type": "string"
          },
          "creators": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true,
              "properties": {
                "name": {
                  "type": "string"
                },
                "platform": {
                  "type": "string"
                },
                "fit": {
                  "type": "string"
                }
              }
            }
          },
          "selection_rationale": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "risks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "next_steps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "source_health": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "status",
                "freshness",
                "confidence",
                "limitations"
              ],
              "properties": {
                "source": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "available",
                    "limited",
                    "unavailable",
                    "not_checked"
                  ]
                },
                "freshness": {
                  "type": "string",
                  "enum": [
                    "live",
                    "recent",
                    "stale",
                    "unknown"
                  ]
                },
                "confidence": {
                  "type": "string",
                  "enum": [
                    "high",
                    "medium",
                    "low"
                  ]
                },
                "limitations": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "limitations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "recommended_next_actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "confidence": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ]
          },
          "capability_id": {
            "type": "string"
          },
          "schema_version": {
            "type": "string"
          }
        }
      },
      "underlying_endpoints": [
        {
          "path": "https://api.chinamarketing.ai/v1/china/kols",
          "price_usd": "0.45",
          "description": "Shortlisted KOL and KOC candidates for China campaign planning.",
          "ttl_seconds": 86400
        }
      ]
    }
  ]
}