摘要
针对市场合作伙伴的 ABOUT YOU 卖家中心 API：订单、带跟踪的运输、发票和装箱单、具有审批状态的产品、库存、价格、类别和属性、品牌和报告。API 密钥。
引导式设置
2 分钟将 ABOUT YOU 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 ABOUT YOU，再把你的 MCP URL 添加到你的 AI 助手。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
ABOUT YOU 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → ABOUT YOU，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需
git clone，无需本地服务器。
ABOUT YOU
针对市场合作伙伴的 ABOUT YOU 卖家中心 API：订单、带跟踪的运输、发票和装箱单、具有审批状态的产品、库存、价格、类别和属性、品牌和报告。API 密钥。
设置
设置大约需要 2 分钟。
- 作为 管理员 用户登录 ABOUT YOU 卖家中心。会员用户无法创建 API 密钥。
- 打开 设置，然后 API 密钥，点击 + 添加。
- 输入标签，选择性地输入到期日期，然后点击 添加密钥。
- 立即将密钥复制到
ABOUT_YOU_API_KEY：卖家中心仅在此时显示密钥。
密钥通过 X-API-Key 头发送。要获取测试数据，请在 设置、沙盒、创建沙盒 下创建一个沙盒：它在同一地址上有自己的 API 密钥，产品在此处无需审批即可上线，测试订单来自订单页面上的 接收订单 按钮。
从哪里开始：about_you_list_orders 通过 order_status 打开显示待发货的订单。about_you_list_products 显示你的目录及其库存和价格。about_you_list_countries 是一个便宜的调用，证明密钥有效。
订单和运输：about_you_list_orders 返回每个订单的项目及其 id；发货、取消和退货工具使用这些项目 ID，而不是 SKU。使用 about_you_ship_order_items 发货（需要从 about_you_list_carriers 获取的承运人密钥、运输跟踪密钥和退货跟踪密钥）。about_you_get_delivery_document 返回一份直邮订单的装箱单，about_you_get_order_invoices 返回客户发票，均为文件格式。about_you_cancel_order_items 和 about_you_return_order_items 默认关闭：已取消的项目无法再发货，标记为退货的项目会使 ABOUT YOU 自动退款给客户。请在收到后 24 小时内检查退货；不要注册你拒绝的退货。
异步写入：每次写入都会立即返回 batchRequestId，并在后台处理。使用 about_you_get_batch_result 读取结果（选择匹配的 result_type），直到状态为完成或失败；每个项目都包含成功和错误。结果保留 7 天。短时间内发送相同的有效负载会返回相同的批处理 ID，并且不会再次处理。
产品：一行代表一个 SKU（一个款式的颜色的尺码）。使用来自 about_you_list_categories、about_you_list_category_attribute_groups 和 about_you_list_brands 的 ID，通过 about_you_upsert_products 创建或更改它们，然后使用 about_you_publish_product 将样式发送至审批。状态包括：草稿、待审批（在 ABOUT YOU 审核期间锁定）、拒绝（原因在 about_you_list_rejected_products 中）、待激活、激活、非激活和问题（一个变为无效的激活产品；修复后会恢复为激活）。about_you_update_product_status（也包括草稿和非激活）和 about_you_delete_product 默认关闭。
库存和价格：about_you_update_stock 和 about_you_update_prices 每次调用最多可处理 1000 行，并始终生效，与通过产品更新发送的库存或价格不同。产品价格为该国货币的十进制数字（49.99），而订单金额为最小单位的整数（4999 = 49.99 EUR）。每个价格都要发送 currency。
报告和 Webhooks：about_you_list_reports 和 about_you_download_report（关于 ABOUT YOU 仓库中商品的库存和移动报告，DAC7），about_you_list_webhooks（只读）。
分页：列表返回 items 和 pagination。订单和产品应使用 cursor = pagination.next_cursor 进行分页；页面参数仍然有效，但已被弃用。较小的列表使用 page 和 per_page（最大 100）。
履行类型：dropshipping 意味着你发货；fulfillment_by_marketplace 意味着 ABOUT YOU 从其自己的仓库发货（FbAY），因此这些订单无需发货，也没有交付文件。
速率限制（每个端点和每个密钥）：订单每分钟 100 次，发货 200 次，取消和退货 50 次，库存 1000 次，价格 200 次，产品列表 1000 次，产品更新和状态 100 次，批处理结果 200 次，发票和报告 10 次。头部 X-RateLimit-Limit 和 X-RateLimit-Remaining 显示预算；429 意味着等待下一分钟。
错误：400 和 401 返回 JSON message。文档的 404 意味着订单没有此类文件。此 API 没有支付或付款调用；导致退款的唯一操作是注册退货，该操作默认关闭。
先决条件：ABOUT_YOU_API_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 ABOUT YOU 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
about_you_list_orders | 列出订单：每个订单的 order_number、状态（打开、已发货、已取消、已退货、混合）、履行类型、承运人密钥、含税成本等… |
about_you_list_carriers | 列出你可以使用的承运人：密钥（例如 DHL_STD_NATIONAL，发货时的 carrier_key 值）、承运人名称、显示标签等… |
about_you_ship_order_items | 将打开的订单项标记为已发货，每个包裹一条记录：其中的订单项 ID、承运人密钥、运输跟踪密钥和退货… |
about_you_cancel_order_items | 取消无法交付的打开订单项（例如缺货）。已取消的项目无法再发货，库存不会增加… |
about_you_return_order_items | 将已发货的订单项注册为退货，附带退货跟踪密钥。一旦项目被标记为退货，ABOUT YOU 会退款给… |
about_you_get_order_invoices | 下载一个订单的客户发票。响应是附加在结果中的文件：PDF 格式，或者当订单有多个… |
about_you_get_delivery_document | 下载直邮订单的交付文件（装箱单），以 PDF 格式附加在结果中。由 ABOUT YOU 发货的订单… |
about_you_list_products | 列出你的产品变体（每个 SKU 一行）：sku、style_key、colorway_key、ean、名称、状态（草稿、待审批、拒绝… |
about_you_list_rejected_products | 列出 ABOUT YOU 在审批中拒绝的产品：style_key、拒绝消息、拒绝原因[]（关键、类型图像要求或… |
about_you_upsert_products | 创建或更新最多 100 个产品变体（每个 SKU 一条记录）。新产品以草稿形式开始；通过 about_you_publish_product 发布它们… |
about_you_publish_product | 发布一个产品（所有变体的样式键）。草稿提交给 ABOUT YOU 审批（待审批，然后待激活，然后… |
about_you_update_product_status | 通过样式键设置一个或多个产品的状态：published（发送至审批或重新上线）、draft（撤回审批；仅… |
about_you_update_stock | 设置最多 1000 个 SKU 的库存数量（你自己的仓库库存；数量为 0 会使该尺码不可用）。使用较旧的… |
about_you_update_prices | 设置最多 1000 个 SKU 和国家对的价格：零售价格和可选的销售价格，以该国货币的十进制数字表示… |
about_you_delete_product | 按 SKU 删除一个变体。当它是某种颜色的最后一个尺码时，该颜色也会被删除，当最后一种颜色被删除时，整个产品… |
about_you_list_categories | 搜索 ABOUT YOU 类别树：id（产品的类别值）、名称、路径（用于显示）、parent_id、material_composition_type… |
about_you_list_category_attribute_groups | 列出类别要求的属性组（颜色、尺码、材料组和其他属性）：每组 id、名称、frontend_name… |
about_you_list_brands | 列出你的账户可以销售的品牌：id（产品的品牌值）和名称。只读，一次调用返回所有，每分钟 50 次调用 |
about_you_list_countries | 列出你的账户销售的国家（代码、名称）、产品描述的语言环境和每个国家的货币（country_code… |
about_you_get_batch_result | 读取异步写入的结果：状态（待处理、处理中、已完成、重试、失败）和 items[] 及请求项目… |
about_you_list_reports | 列出 ABOUT YOU 为你的账户生成的报告文件：id、类型（可销售库存、仓库移动、DAC7）、文件名、日期… |
about_you_download_report | 按 id 下载一个报告文件。文本文件（CSV）作为文本返回，任何其他格式作为附加在结果中的文件。只读，10… |
about_you_list_webhooks | 列出账户的 webhook 订阅：id、url、事件（order.created、order.shipped、stock.updated 等）、启用状态… |
示例提示
- "哪些 ABOUT YOU 订单是打开的并等待发货？"
- "我的哪些产品被 ABOUT YOU 拒绝了，原因是什么？"
- "将 SKU AY-TSHIRT-WHT-M 的库存设置为 50。"
- "使用 DHL 发货订单 123456789 的商品，跟踪 003404341612345678 和退货跟踪 003404341698765432。"
- "下载上个月的销售报告。"
下一步
这份指南对你有帮助吗?