连接器指南阅读约 6 分钟38 个 MCP 工具7 种语言

连接 Shop Apotheke MCP 与 Gemini CLI

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

HC作者:HelpCode 团队更新于 6 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Shop Apotheke Marketplace

Shop Apotheke Marketplace

Run your shop on the Shop Apotheke marketplace from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, imports, messages, returns, invoices and transactions. The marketplace sells in Germany, Austria, Italy and Belgium; sign in with the shop API key from your Shop Apotheke seller back office.

个工具

38

区域

INTL

类别

电子商务

身份验证

API Key

所需环境变量

SHOP_APOTHEKE_API_KEY
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

引导式设置

2 分钟将 Shop Apotheke Marketplace 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Shop Apotheke Marketplace,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Shop Apotheke Marketplace 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Shop Apotheke Marketplace · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Shop Apotheke Marketplace,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Shop Apotheke Marketplace + Gemini

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

前提条件

查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。该连接器所需的环境变量为:

SHOP_APOTHEKE_API_KEY

第一步 — 获取凭据

国家:德国、奥地利、意大利和比利时。该市场在德国和奥地利上线;意大利(redcare.it)和比利时(farmaline.be)在各自的合同下运行合作伙伴计划。

谁可以销售:Shop Apotheke 批准每个合作伙伴,可能会先审核产品信息流,并为每个国家签署合同;在其合作伙伴页面申请。连接器需要一个 Shop Apotheke 已经开通的卖家账户。

只有德国和奥地利的商店在此地址上得到确认;意大利和比利时的商店也假定使用此地址。

设置大约需要 5 分钟。

  1. 登录到 Shop Apotheke 卖家后台:https://shopapotheke.mirakl.net/login。
  2. 在后台打开你的用户名(右上角) > 我的用户设置 > API 密钥,然后点击 生成新密钥(或复制现有密钥)。将其粘贴到 SHOP_APOTHEKE_API_KEY 中。密钥以原样形式发送在 Authorization 头中,不带 Bearer。生成新密钥会使旧密钥失效,因此使用旧密钥的任何其他工具将停止工作。
  3. Shop Apotheke 为每个国家签署单独的合同,因此在多个国家的卖家有多个商店。如果你的用户有多个商店,将 SHOP_APOTHEKE_SHOP_ID 设置为该连接器应在其上工作的商店的数字 ID(在后台仪表板的 标识符 或 商店 ID 旁边显示,并由 shop_apotheke_get_account 返回为 shop_id);要在多个商店上工作,每个商店安装一次连接器。没有它将使用你的默认商店。
  4. 安装并运行 shop_apotheke_get_account:它返回密钥所属的商店。

从哪里开始:shop_apotheke_get_account 显示密钥背后的商店(id、名称、状态、货币和渠道)。日常工作中使用 shop_apotheke_list_orders,参数为 order_state_codes=WAITING_ACCEPTANCE,使用 shop_apotheke_list_offers 获取价格和库存,使用 shop_apotheke_list_threads 获取等待回复的消息。

产品和竞争报价:shop_apotheke_get_products 通过 EAN 或其他参考在 Shop Apotheke 目录中查找产品,并返回市场产品 SKU;shop_apotheke_list_product_offers 列出每个商店对给定产品的报价,按最佳价格排序,每分钟大约 5 次调用。

订单工作流程:新订单在 WAITING_ACCEPTANCE 中等待。shop_apotheke_accept_order 接受(或拒绝)每一行;在客户扣款后,订单转移到 SHIPPING。然后 shop_apotheke_update_tracking 存储承运人和跟踪号码(承运人代码来自 shop_apotheke_list_carriers),shop_apotheke_ship_order 确认发货(SHIPPED)。后续状态为 TO_COLLECT、RECEIVED、CLOSED、REFUSED 和 CANCELED。使用 shop_apotheke_list_orders,参数为 order_state_codes=WAITING_ACCEPTANCE,获取日常待办事项列表,使用 has_incident=true 获取未解决的事件;shop_apotheke_resolve_incident 在问题解决后关闭一个订单行上的事件。附加到订单的文件(交货单、标签、客户发票)由 shop_apotheke_list_order_documents 列出。

写入:先确认。 shop_apotheke_accept_order、shop_apotheke_update_tracking、shop_apotheke_ship_order、shop_apotheke_resolve_incident、shop_apotheke_accept_return、shop_apotheke_receive_return、shop_apotheke_update_offers、shop_apotheke_reply_thread、shop_apotheke_create_order_thread 和 shop_apotheke_import_products 在实时市场上操作。在每次调用之前,向用户展示将要更改的内容(订单 ID 和行、跟踪号码、报价 SKU 及其旧价格和新价格或库存、消息文本和收件人),并等待确认。拒绝订单行将永久取消。此处没有工具可以退款、取消订单或转移资金;请在后台处理。shop_apotheke_import_offers 可以删除报价(REPLACE 模式删除文件中缺失的每个报价),因此它的安装是关闭的。

更新报价(价格和库存):shop_apotheke_update_offers(OF24)替换整个报价。你省略的每个字段都会被重置:缺失的 quantity 变为 0,缺失的 discount 或 description 被删除。始终先读取报价(shop_apotheke_get_offer 或 shop_apotheke_list_offers,参数为 sku),然后将其完整发送回去,仅包含预期的更改:shop_sku、product_id 和 product_id_type(来自 product_references)、state_code、price、quantity、leadtime_to_ship、logistic_class(其代码)、min_quantity_alert、description、discount、all_prices、available_started / available_ended(读取为 available_start_date / available_end_date)和任何 offer_additional_fields。将 update_delete 留空或设置为 update。调用返回一个 import_id;更改是异步应用的,因此在再次读取报价之前,请使用 shop_apotheke_get_offer_import 检查它。state_code 的条件代码来自 shop_apotheke_list_offer_conditions,物流类别代码来自 shop_apotheke_list_logistic_classes。

文件导入:shop_apotheke_import_products(P41)和 shop_apotheke_import_offers(OF01)接受 Shop Apotheke 要求的 CSV、XLSX 或 XML 文件的 URL;连接器下载并将其上传到 Shop Apotheke。使用 shop_apotheke_list_product_imports / shop_apotheke_get_product_import 和 shop_apotheke_list_offer_imports / shop_apotheke_get_offer_import 跟踪它们。

退货:shop_apotheke_list_returns(RT11)列出退货请求。在 Shop Apotheke 允许商店决定的情况下,shop_apotheke_accept_return 在 WAITING_ACCEPTANCE 中接受或拒绝请求,shop_apotheke_receive_return 确认商品已到达。退款留在后台处理。

消息:shop_apotheke_list_threads 列出与客户和 Shop Apotheke 的对话(通过 entity_type=MMP_ORDER 和 entity_id=<order id> 过滤特定订单;没有 entity_type 的 entity_id 将被拒绝),shop_apotheke_get_thread 读取一条消息及其内容,shop_apotheke_reply_thread 回复(收件人 CUSTOMER 或 OPERATOR,即 Shop Apotheke),shop_apotheke_create_order_thread 在订单上开启新的对话。主题的原因代码来自 shop_apotheke_list_reasons;除非你知道市场有该语言,否则将其 locale 留空(非活动语言将返回 400)。

资金:shop_apotheke_list_invoices(IV01)列出 Shop Apotheke 向商店发出的会计文件,shop_apotheke_list_transactions(TL02)列出交易行(销售、佣金、退款、付款)。如果 Shop Apotheke 使用增强卖家开票,IV01 将不返回新文件;然后使用 shop_apotheke_list_document_requests(DR11)和交易。

参考列表:shop_apotheke_list_channels(国家网站)、shop_apotheke_list_carriers、shop_apotheke_list_shipping_zones、shop_apotheke_list_shipping_methods 和 shop_apotheke_list_logistic_classes 变化很少;每次对话读取一次。

分页:订单、报价、发票和产品导入使用 max(最多 100)和 offset 进行分页。线程、退货、交易、文档请求和报价导入返回 next_page_token;将其作为 page_token 传递以获取下一页(所有其他过滤器将被忽略),直到它缺失。

日期为 ISO 8601,例如 2026-10-01T00:00:00Z;答案为 UTC。

速率限制:每个 API 有其自己的限制,Shop Apotheke 可以收紧它们。列出报价和订单旨在用于交互式使用,产品和报价导入最多每 15 分钟一次,shop_apotheke_get_account 和参考列表大约每天调用一次。429 会带有 Retry-After 头,指示等待的秒数;请勿在循环中重试。

错误:401 表示密钥错误或已被新密钥替换,403 表示你的用户没有此操作的权限,404 表示该商店不存在该订单、报价或线程,400 表示参数错误或订单处于错误状态(消息会说明,例如 ORDER_INVALID_STATE)。

第二步 — 安装适配器

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

第三步 — 在 Gemini 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 gemini。
  3. 在 Gemini CLI 中运行 /mcp(或在终端运行 gemini mcp list)— anythingmcp 应显示为已连接。
  4. 开始输入提示 — Gemini CLI 现在可以调用 Shop Apotheke Marketplace 的工具。

可用工具

工具功能
shop_apotheke_get_account读取该市场上 API 密钥背后的商店(A01):商店 ID 和名称、状态、渠道、货币、等级和批准率、联系方式…
shop_apotheke_list_orders列出订单(OR11)及其行、客户、送货地址、价格、状态和事件。按状态过滤(例如 WAITING_ACCEPTANCE…
shop_apotheke_list_offers列出商店的报价(OF21):SKU、产品、价格和折扣、所有渠道价格、库存数量、状态、交货时间和是否…
shop_apotheke_get_offer通过报价 ID(OF22)读取完整报价:每个价格字段、折扣、数量、状态、物流类别、交货时间和自定义…
shop_apotheke_list_offer_conditions列出市场接受的报价条件(OF61),例如新或旧,更新报价时放入 state_code 的代码
shop_apotheke_list_offer_imports列出报价导入和更新(OF04),来自文件和 shop_apotheke_update_offers:状态(WAITING、RUNNING、COMPLETE、FAILED)、行…
shop_apotheke_get_offer_import通过其 import_id 读取一个报价导入或报价更新的状态(OF02),由 shop_apotheke_update_offers 或…
shop_apotheke_export_offers将店铺的全部报价导出为文件(OF52),用于读取整个目录(每个 SKU 的价格和库存),无需逐页调用 shop_apotheke_list_offers
shop_apotheke_get_offer_export_status查询由 shop_apotheke_export_offers 启动的报价导出状态(OF53):PENDING、COMPLETED 或 FAILED,完成后返回文件的 URL
shop_apotheke_get_offer_export_file读取已完成报价导出的一个文件(OF54):包含 SKU、商品、数量、价格及其他导出字段的报价,格式为 JSON 或 CSV
shop_apotheke_list_product_imports列出产品导入(P51)及其状态(WAITING、RUNNING、SENT、COMPLETE、FAILED、CANCELLED)、转换计数和…
shop_apotheke_get_product_import通过其 import_id 读取一个产品导入(P42)的状态:导入状态、原因、转换计数和集成细节…
shop_apotheke_get_products通过其标识符(P31)在市场目录中查找产品,例如 EAN,并获取市场产品 SKU、标题和类别…
shop_apotheke_list_product_offers列出每个商店对给定产品的报价(P11),按最佳价格排序,以便与竞争对手的价格进行比较。提供 product_ids…
shop_apotheke_list_threads列出与客户和 Shop Apotheke 的消息线程(M11):主题、关联的订单或报价、参与者、最后消息日期以及自…
shop_apotheke_get_thread读取一条消息线程(M10)及其所有消息、发送者、收件人、附件和关联的订单或报价
shop_apotheke_list_returns列出退货请求(RT11),包括其状态、退货行、原因、RMA、跟踪和关联的订单。按状态、订单或日期过滤…
shop_apotheke_list_reasons列出市场的原因代码(RE01):事件、取消、退款和消息原因,带有其标签以及商店是否可以…
shop_apotheke_list_carriers列出市场已知的承运人(SH21),包括其代码、标签和跟踪 URL。使用代码作为 carrier_code 在…
shop_apotheke_list_invoices列出 Shop Apotheke 向商店发出的会计文件(IV01):发票和信用票据,带有期间、总额(含税和不含税)…
shop_apotheke_list_transactions列出商店的交易行(TL02):订单金额、运费、佣金、退款、手动信用和付款,带有金额、类型…
shop_apotheke_list_document_requests列出会计文件请求(DR11),用于 Shop Apotheke 运行增强卖家开票时:发票和信用票据,Shop…
shop_apotheke_list_order_documents列出附加到一个或多个订单的文件(OR72):交货单、运输标签、客户发票和其他文件,带有 ID、文件…
shop_apotheke_list_channels列出市场的销售渠道(CH11),通常每个国家网站一个,带有代码和标签。使用代码作为 channel_codes 在…
shop_apotheke_list_shipping_zones列出市场的活跃运输区域(SH11),带有代码和标签,例如法国本土或科西嘉。变化很少:每次调用…
shop_apotheke_list_shipping_methods列出市场的活跃运输方式(SH12),例如标准、快递或自取,带有代码、标签、是否有跟踪号码…
shop_apotheke_list_logistic_classes列出市场的物流类别(SH31),决定运输价格的大小或重量区间,带有代码和标签。使用代码作为…
shop_apotheke_accept_order接受或拒绝等待接受的订单行(OR21)。每一行订单必须列出。拒绝一行将永久取消…
shop_apotheke_update_tracking设置订单的承运人和跟踪号码(OR23)。提供来自 shop_apotheke_list_carriers 的 carrier_code,或承运人名称…
shop_apotheke_ship_order确认已发货的订单在 SHIPPING 状态(OR24);它转移到 SHIPPED,并通知客户。首先使用… 设置跟踪
shop_apotheke_update_offers创建或更新报价,包括价格和库存(OF24)。完全替换每个报价:省略的每个字段都会被重置(缺失的…
shop_apotheke_reply_thread在消息线程(M12)中回复客户或 Shop Apotheke。消息立即发送,无法撤回:向用户展示…
shop_apotheke_create_order_thread在订单(OR43)上与客户、Shop Apotheke 或两者开始新的消息线程。消息立即发送:向用户展示…
shop_apotheke_resolve_incident将一个订单行上的未解决事件标记为已解决(OR64),一旦客户的问题得到解决。reason_code 必须是 INCIDENT_CLOSE…
shop_apotheke_accept_return接受或拒绝在 WAITING_ACCEPTANCE 中的退货请求(RT21)。仅当 Shop Apotheke 在卖家后台处理退货时…
shop_apotheke_receive_return确认已接受的退货商品已到达你的仓库(RT25)。退货状态转为 RECEIVED。实时市场上操作…
shop_apotheke_import_products向市场发送产品文件(P41),以在其目录中创建或丰富产品。file_url 是 CSV、XLSX 或 XML 文件的地址…
shop_apotheke_import_offers导入报价文件(OF01),以批量创建、更新或删除报价。REPLACE 模式删除文件中不存在的每个报价,…

示例提示

  • "哪些 Shop Apotheke 订单在等待我的接受?"
  • "将我的镁胶囊 SKU MG-400-90 的库存设置为 120。"
  • "哪些退货请求在等待我的决定?"
  • "将 DHL 跟踪 00340434161234567891 添加到订单 6604412-A 并确认发货。"
  • "显示 Shop Apotheke 在十月份发给我的发票。"

常见问题

我在哪里可以获得 Shop Apotheke API 密钥? 在 Shop Apotheke 卖家后台:你的用户名(右上角)、我的用户设置、API 密钥,然后 生成新密钥(或复制现有密钥)。生成新密钥会使旧密钥失效。Shop Apotheke 为每个国家签署单独的合同,因此在多个国家的卖家有多个商店。如果有多个商店,将 SHOP_APOTHEKE_SHOP_ID 设置为该连接器应在其上工作的商店。

谁可以在 Shop Apotheke 上销售,覆盖哪些国家? Shop Apotheke 批准每个合作伙伴,可能会先审核产品信息流,并为每个国家签署合同;在其合作伙伴页面申请。该连接器覆盖德国、奥地利、意大利和比利时。该市场在德国和奥地利上线;意大利(redcare.it)和比利时(farmaline.be)在各自的合同下运行合作伙伴计划。只有德国和奥地利的商店在此地址上得到确认;意大利和比利时的商店也假定使用此地址。

它可以取消订单、退款或删除报价吗? 没有工具可以退款或取消订单;请在 Shop Apotheke 后台处理。接受订单时拒绝一行将永久取消,因此 AI 会向你展示每个写入操作并等待确认。shop_apotheke_import_offers 安装时是关闭的,因为其 REPLACE 模式会删除文件中缺失的每个报价;仅当 AI 应该使用它时,才在连接器页面上打开。

Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

这份指南对你有帮助吗?

2 分钟将 Shop Apotheke Marketplace 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Shop Apotheke Marketplace,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

相关指南

连接器

连接 Shop Apotheke MCP 与 ChatGPT

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

连接器

连接 Shop Apotheke MCP 与 Claude

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

连接器

连接 Shop Apotheke MCP 与 Microsoft Copilot

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

连接器

连接 Shop Apotheke MCP 与 Cursor

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

连接器

连接 Shop Apotheke MCP 与 Meta Muse

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和运输、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。

连接器

Shop Apotheke MCP 服务器:订单、报价与配送

通过 AI 代理在 Shop Apotheke 市场上运营你的商店:订单、接受、跟踪和发货、事件、带有价格和库存的报价、导入、消息、退货、发票和交易。该市场在德国、奥地利、意大利和比利时销售;使用来自你的 Shop Apotheke 卖家后台的商店 API 密钥登录。