{"schema_version":"1.0","server":{"name":"etsy-backend","description":"MeliCreativeGift ERP 后端 API（路径前缀 /api）。base_url 等域名字段由 Laravel 在 GET /docs/api/mcp-tools.json 响应时根据 .env 的 APP_URL 注入；仓库内静态文件可为 null。","base_url":"https://tiancase.com","erp_admin_url":"https://tiancase.com/admin","docs_url":"https://tiancase.com/docs/api","mcp_tools_json_url":"https://tiancase.com/docs/api/mcp-tools.json","app_url_env":"APP_URL","external_api_key_header":"X-Api-Key","external_api_key_note":"除 get_api_user 外，所有列出的 path 均须在请求头附带 X-Api-Key（ERP 后台「API Key」创建）。"},"tools":[{"name":"get_api_user","description":"获取当前 OAuth 用户（Passport auth:api）。GET /api/user，需 Authorization: Bearer {token}。","method":"GET","path":"/api/user","auth":"bearer","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_head","description":"乐高分类「头」产品 code 列表。GET /api/legos-head","method":"GET","path":"/api/legos-head","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_body","description":"乐高分类「身」产品 code 列表。GET /api/legos-body","method":"GET","path":"/api/legos-body","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_hair","description":"乐高 hair 分类产品 code 列表。GET /api/legos-hair","method":"GET","path":"/api/legos-hair","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_leg","description":"乐高 leg 分类产品 code 列表。GET /api/legos-leg","method":"GET","path":"/api/legos-leg","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_brick","description":"乐高 brick 分类产品 code 列表。GET /api/legos-brick","method":"GET","path":"/api/legos-brick","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_cate","description":"乐高分类名列表。GET /api/legos-cate","method":"GET","path":"/api/legos-cate","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"get_api_legos_sku","description":"全部产品 SKU code。GET /api/legos-sku","method":"GET","path":"/api/legos-sku","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":false}},{"name":"post_api_v1_tracks","description":"物流/轨迹回调：写入 Test 表并可能按运单号更新订单轨迹状态。POST /api/v1/tracks","method":"POST","path":"/api/v1/tracks","auth":"x_api_key","inputSchema":{"type":"object","description":"通常为 JSON 体，含 event、data 等（与对接方约定）","additionalProperties":true}},{"name":"get_api_v1_etsy","description":"调试用：将请求体写入 Test 表。GET /api/v1/etsy","method":"GET","path":"/api/v1/etsy","auth":"x_api_key","inputSchema":{"type":"object","properties":[],"additionalProperties":true}},{"name":"post_api_v1_etsy","description":"调试用：将请求体写入 Test 表。POST /api/v1/etsy","method":"POST","path":"/api/v1/etsy","auth":"x_api_key","inputSchema":{"type":"object","additionalProperties":true}},{"name":"get_api_v1_tracking_text","description":"按订单或运单返回拼好的英文物流说明文本。GET /api/v1/tracking-text","method":"GET","path":"/api/v1/tracking-text","auth":"x_api_key","inputSchema":{"type":"object","properties":{"order_id":{"type":"integer","description":"订单主键，与 tracking_number 二选一"},"tracking_number":{"type":"string","description":"运单号；与 order_id 二选一"},"format":{"type":"string","enum":["text","json"],"description":"为 text 时返回 text/plain"}},"additionalProperties":false}},{"name":"get_api_logistics","description":"云途等物流查询（内部再调 openapi）。GET /api/logistics","method":"GET","path":"/api/logistics","auth":"x_api_key","inputSchema":{"type":"object","properties":{"tracking_number":{"type":"string"},"order_number":{"type":"string"}},"additionalProperties":false}},{"name":"post_api_etsy_message","description":"Etsy 会话：按店铺 ShopPrompt 调 SiliconFlow 生成回复。POST /api/etsy/message","method":"POST","path":"/api/etsy/message","auth":"x_api_key","inputSchema":{"type":"object","required":["shop_name"],"properties":{"shop_name":{"type":"string","description":"店铺名，对应 shop_prompts.shop_name"},"order_number":{"type":"string"},"buyer_name":{"type":"string"},"messages":{"type":"array","items":{"type":"object","properties":{"sender":{"type":"string","description":"buyer 表示买家"},"content":{"type":"string"}},"required":["sender","content"]}}},"additionalProperties":true}},{"name":"post_api_shop_statistics","description":"店铺日统计 upsert。POST /api/shop-statistics","method":"POST","path":"/api/shop-statistics","auth":"x_api_key","inputSchema":{"type":"object","required":["shop_id","date"],"properties":{"shop_id":{"type":"string","maxLength":50},"date":{"type":"string","format":"date"},"ad_impressions":{"type":"integer","minimum":0},"ad_clicks":{"type":"integer","minimum":0},"ad_click_rate":{"type":"number","minimum":0,"maximum":100},"ad_spend":{"type":"number","minimum":0},"ad_orders":{"type":"integer","minimum":0},"ad_revenue":{"type":"number","minimum":0},"total_orders":{"type":"integer","minimum":0},"total_revenue":{"type":"number","minimum":0},"total_views":{"type":"integer","minimum":0},"total_visits":{"type":"integer","minimum":0},"conversion_rate":{"type":"number","minimum":0,"maximum":100},"ad_revenue_ratio":{"type":"number","minimum":0,"maximum":100}},"additionalProperties":true}},{"name":"post_api_product_statistics","description":"商品日统计 upsert。POST /api/product-statistics","method":"POST","path":"/api/product-statistics","auth":"x_api_key","inputSchema":{"type":"object","required":["listing_id","shop_id","date"],"properties":{"listing_id":{"type":"integer"},"shop_id":{"type":"string","maxLength":50},"date":{"type":"string","format":"date"},"visits":{"type":"integer","minimum":0},"total_views":{"type":"integer","minimum":0},"orders":{"type":"integer","minimum":0},"revenue":{"type":"number","minimum":0},"impression_count":{"type":"integer","minimum":0},"click_count":{"type":"integer","minimum":0},"spent_total":{"type":"number","minimum":0},"conversions":{"type":"integer","minimum":0},"ad_revenue":{"type":"number","minimum":0},"click_rate":{"type":"number","minimum":0,"maximum":100},"roas":{"type":"number","minimum":0}},"additionalProperties":true}},{"name":"post_api_orders_import","description":"订单批量导入（与后台 Excel「导入订单」同逻辑）。POST /api/orders/import。Content-Type: application/json。","method":"POST","path":"/api/orders/import","auth":"x_api_key","inputSchema":{"type":"object","required":["account_id","rows"],"properties":{"account_id":{"type":"integer","description":"accounts.id"},"excel_format":{"type":"boolean","description":"true 时第一行为 Etsy 表头（第3列为 Buyer），rows 为列下标数组"},"rows":{"type":"array","minItems":1,"items":{"type":"object","description":"命名字段行须含 receipt_id；或 0..n 连续下标数组表示 Excel 列","additionalProperties":true}}},"additionalProperties":false}}]}