MakeBox for Etsy

MakeBox for Etsy

Version 0.3.4 提供 Etsy SEO 策略指导和七个引导式工作流。即使没有 MCP 连接也能使用：提供产品信息、照片、粘贴的商品刊登内容或 CSV，即可获得完整的可直接复制的字段、设置工作表，以及明确标注的待确认事实。同样的知识也支持通过卖家已授权的 MakeBox 工作区执行连接操作。

该管理器融合 SEO、产品定位、转化文案、选项、配送和谨慎的店铺运营。它不会猜测材质、包装尺寸、搜索量、配送承诺或排名结果。长篇描述会完整返回，并保留其中的事实信息部分。示例和可填写模板展示了生成结果。

无需连接器即可使用

可以提出“根据这些产品详情创建完整的商品刊登内容”“改进这段粘贴的描述，但保留规格”或“分析我的关键词 CSV”等请求。该插件会准备标题、完整描述、标签、适用的属性/材质、个性化选项、商品选项，以及配送/数字商品设置。缺失的信息会列在面向买家的文案之外。手动交接会告知卖家需要在 Etsy 中粘贴/选择哪些内容，以及发布前需要检查什么。使用这些指令内容无需账号、令牌或订阅；但仍受宿主自身的模型/访问规则约束。

独立版软件包包含相同的技能、角色、指南、示例和可选 QA，并使用空的 MCP 配置。连接版软件包增加了远程 MakeBox 声明；即使工具未连接，其编辑工作仍可使用。Agent 定义不会强制所有客户端都启动单独的 Agent。对于支持技能但不支持 Agent 文件的客户端，协调技能会承载该角色。

可选的 Etsy 实时操作

该服务提供适配器，涵盖官方 Etsy API 快照（日期为 2026 年 10 月 1 日）中的全部 105 项操作，以及 MakeBox 工作流。随附的操作索引/输入架构已于 10 月 4 日与本地运行时核对。实时工具架构仍是权威依据。此范围涵盖已发布的 API 操作，但不包括 Etsy 网站的全部功能。可用性取决于权限范围、应用访问权限、有效的产品数据以及 MakeBox 访问权限。直接通过 Etsy 传输不会调用其他模型，也不会扣减 MakeBox AI 使用额度；但仍可能产生 Etsy 费用。

连接并使用

安装连接版，然后在需要实时操作时通过 OAuth 连接 MakeBox。使用 list_shops 和 get_account_status 确认工作区/访问权限。私有操作会绑定卖家的店铺；公开研究可读取其他店铺的信息。准备文案无需连接。

可以尝试“更改此商品刊登的配送配置文件”“根据这份完成的文案创建 Etsy 草稿”“显示我最新的订单和付款账本”或“研究相关关键词”。Claude 会使用实时工具架构，而不是插件中嵌入的固定列表。如果现有对话中缺少新添加的工具，请刷新连接器或开始新对话；工具发现和缓存取决于客户端。

直接执行 etsy_* 操作会使用 Etsy ID，无需先导入到 MakeBox。写入操作需要针对确切目标和值进行授权。HTTP 请求成功与通过最新读取确认最终状态是两回事。用户请求这些工作流时，现有的 MakeBox 草稿、研究、优化和批量作业工具仍可使用。此 MCP 连接器不提供图像和视频生成；可以上传和管理现有文件。

数据与支持

连接器会将所选工具请求发送到 https://mcp.makebox.ai/mcp，由其使用卖家的 OAuth 授权调用 Etsy。直接操作可能涉及商品详情、订单和买家信息、配送信息、付款记录及店铺政策。仅显示卖家完成任务所需的数据。可选的个人 Etsy 邮箱/地址方法需要额外的 Etsy 授权；普通连接不会自动获得这些权限。

该插件不包含凭据或自主后台工作进程。可选的 Python 脚本用于本地结构检查和构建参考文件；它们不会发起网络请求、消耗额度或执行任何 Etsy 操作。没有钩子会自动运行这些脚本。卖家所有的文件仅会在授权范围内通过 get_upload_link 或 Asset Library 上传；直接多部分字段使用 asset_id。切勿分享令牌或任意路径。

请参阅 MakeBox 主页、插件文档、隐私政策、服务条款和支持/联系页面。插件使用受随附的专有许可证约束。

组件

• agents/makebox-etsy-manager.md：在 Cowork 和 Claude Code 中协调工作。
• skills/makebox-shop-manager/SKILL.md：在普通 Claude 聊天中担任协调角色。
• skills/use-etsy-api/SKILL.md：直接 API 探索、授权、传输和回读。
• skills/create-etsy-listing/SKILL.md：完整的商品草稿、选项、政策和媒体。
• skills/optimize-etsy-listing/SKILL.md：在聊天中撰写改进内容，或按明确请求执行 MakeBox AI 任务。
• skills/manage-etsy-orders/SKILL.md：当前订单、交易、付款记录及经授权的履约操作。
• skills/research-etsy-market/SKILL.md：公开的 Etsy 观察结果和 MakeBox 关键词证据。
• skills/manage-etsy-shop/SKILL.md：配送、退货、分区、处理和店铺设置。
• references/direct-etsy-api-guide.md：直接连接器规范和示例。
• .mcp.json：远程服务 URL；不随附服务端代码和凭据。

知识与检查

插件地图会将 Agent/技能引导至事实、文案、关键词证据、变体、个性化、配送/包装、媒体/数字内容、订单、API 配方和 105 个架构。应逐步加载特定任务指南，而非将整个目录都加载到每个文案请求中。

可选的本地检查（Python 3）：

python3 scripts/check-listing.py examples/physical-desk-sign.json
python3 scripts/check-listing.py examples/digital-weekly-planner.json
python3 tests/test-listing-qa.py
uv run --with PyYAML --with jsonschema python scripts/validate-bundle.py

generated QA 要求以空格分隔语言包含 13 个唯一的多词短语。--mode native 会检查原生标签的数量/长度结构，而不强制执行内部 AI 门槛。这些检查无法验证真实性、相关性、知识产权、Etsy 状态或 SEO 结果。请使用实质性发布检查清单。

使用 python3 scripts/build-api-reference.py <official-operation-manifest.json> --date YYYY-MM-DD 维护 API 参考；使用 validate-bundle.py --runtime-schemas <export.json> 与实际运行时的导出进行比对。配方中的 ID 仅作示例，绝不能未经修改就执行。

在未加载 Agent 文件的情况下，Claude 聊天会使用协调技能；兼容的 Cowork/Code 运行时可以加载管理 Agent。Codex 打包通过其入门技能提供相同角色，但不声称支持不具备的 Agent 加载器。仅安装 Muse 连接器并不会安装这些 Markdown 说明；只能通过 Muse 实际提供的功能导入，或将其用作项目说明。远程工具的变更来自 MCP；知识的变更需要更新插件。准备好的归档文件或更新后的 GitHub 软件包并不意味着市场审核已获批准。请参阅 CHANGELOG.md。