API 文档
集成 MartCore 到你的应用所需的一切：快速开始、鉴权、endpoint、schema、MCP Skills 和代码示例。
Quick Start
从零到首次 API 调用，5 分钟搞定
1
获取 API Key
注册账号，在控制台创建 Bearer Token。
2
选择 endpoint
从商品、市场、评论、历史、Fashion AI、爬虫或 MCP Skills 中选择。
3
发送 JSON 请求
所有 v2 endpoint 都接受 JSON body，返回干净结构化 JSON。
4
交给 Agent 使用
响应字段稳定，适合直接进入 Claude、Cursor、Cline 或业务工作流。
terminal
curl -X POST https://mart.tk.com/openapi/v2/amazon/markets/search \
-H "Authorization: Bearer mc_live_xxx" \
-H "Content-Type: application/json" \
-d '{"marketplace":"US","categoryKeyword":"headphones","topN":"10"}'身份认证
所有 API 请求都使用 Bearer Token。请在服务端保存 key，不要放到浏览器端或公开仓库。
Authorization: Bearer mc_live_xxxxxxxxxxxxxxxxxxxx泄露的 Key 可以在控制台立即撤销并重新生成。后端会按 API Key 记录用量、缓存命中和 credit 消耗。
核心 Endpoint
为 AI Agent 优化的 V2 接口，统一 JSON 输入输出。
商品搜索
POST
/openapi/v2/amazon/products/search按关键词、类目、销量、评分和价格筛选商品。
实时商品
POST
/openapi/v2/amazon/products/get获取实时价格、库存、BSR、评分和 Buy Box 信号。
市场分析
POST
/openapi/v2/amazon/markets/search品类需求、收入、集中度、新品率和机会判断。
竞品分析
POST
/openapi/v2/amazon/products/compare按 ASIN、品牌、卖家或关键词发现竞品。
评论分析
POST
/openapi/v2/amazon/reviews/analyze把评论转成情绪、痛点、场景、关键词和购买因素。
评论搜索
POST
/openapi/v2/amazon/reviews/search按评分、verified、日期和标签搜索原始评论。
价格历史
POST
/openapi/v2/amazon/products/history查询价格、BSR、销量、评分历史曲线。
Fashion AI
POST
/openapi/v2/model/fashion-similarity图片检测、Embedding 和文图相似度。
标准响应结构
所有接口返回稳定结构，方便 Agent、MCP tools、工作流系统和业务后端直接消费。
data业务数据主体。商品、市场、评论、历史等模块都在这里返回结构化结果。
meta分页、额度消耗、requestId、cacheHitLayer、dataAge 等元信息。
error失败时返回标准错误结构，包含 code、message、details。
creditsConsumed本次请求消耗额度，缓存命中时按折扣计费。
response.json
{
"success": true,
"data": {
"sampleAvgPrice": 34.99,
"sampleAvgMonthlyRevenue": 124500,
"sampleTop10BrandSalesRate": 0.42
},
"meta": {
"requestId": "req_...",
"cacheHitLayer": "upstream",
"creditsConsumed": 1
}
}MCP / Agent 接入
同一套能力可以通过 REST API、Web Console 和 MCP Skills 调用。
claude_desktop_config.json
{
"mcpServers": {
"martcore": {
"command": "npx",
"args": ["-y", "@martcore/mcp-server"],
"env": {
"MARTCORE_API_KEY": "mc_live_your_key_here"
}
}
}
}准备开始集成？
注册获得试用额度，或者直接在控制台测试 endpoint。