内容
-mcp
上下文协议服务器，封装了 [E API v3](https://developers.etsy.com/documentation/) 作为**纯粹的能力原语**。构建用于让 AI 代理（Claude, ChatGPT, Gemini, 本地 Llama）能够大规模管理 Etsy 店铺，而不受内置启发式算法的干扰。
[](https://github.com/mofiaboss/etsy-mcp/actions/workflows/ci.yml)
[](https://pypi.org/project/etsy-mcp/)
[](https://www.python.org/downloads/)
[
## 这是什么
13 类共 90 种工具 — 您的代理需要的每个端点：
- 读取店铺、商品、商品图片/视频/库存/属性/翻译文件
- 管理收据、付款、运费配置
- 遍历卖家分类法和读取评论
- 查询用户和买家地址
- 从模板批量创建商品（限速友好 批量更新整个店铺的商品图片替代文本
每个工具 API 端点的薄封装。**无评分算法。无 SEO 启发式算法。无标签生成器。无“AI 搜索就绪”判断。** MCP 是能力层；您的模型是推理层。
## 为什么是纯粹的原语
内置的 `seo_score_listing` 启发式算法在上线当天就会过时。AI 排名算法不断变化，Claude/GPT/Gemini/Llama 都对 SEO 有不同的推理。通过将所有判断放在模型中，MCP 在每个代理上都以相同的方式工作，并且随着 Etsy 的算法和您的模型的发展而继续工作。代码更少，测试表面更小，没有隐藏的智能需要调试。参见 [docs/WORKFLOWS.md](docs/WORKFLOWS.md) 以获取仅使用原语的端 LLM 驱动工作流示例。
## 比较
| 项目 | | 内置推理？ |
---|
| [aserper/etsy-mcp](https://github.com/aserper/etsy-mcp) | 37 | 部分 |
profplum700/etsy-mcp](https://github.com/profplum700/etsy) | 10 | 部分 |
| **etsy-mcp项目）** | **90 **无 — 纯粹语** |
## 快速开始
### 安装
```bash
uvx etsy-mcp@latest --help
```
或安装到项目中：
```bash
uv add etsy-mcp
```
### 身份验证
```bash
etsy-mcp auth login
```
这将引导您完成 OAuth 2.0 + PKCE 流程，打开您的浏览器，在 `localhost:3456` 上捕获回调，并将令牌写入 `~/.config/etsy-mcp/tokens.json` 0600）。刷新令牌会自动旋转；只有在刷新令牌失效时，您才需要重新身份验证。
### 注册 Claude 代码
```claude mcp add -- uvx etsy-mlatest
```
或在 `claude_desktop_config.json` 中：jsonc
{
mcpServers": {
y": {
"command": "uvx",
" ["etsy-mcp@ "env": {
"ETSY_KEYSTRING": "您的应用密钥字符串"
}
}
}
```
## 文档
- [docs/ARCHITECTURE.md](ARCHITECTURE.md层和职责
-/OAUTH.md](docs/OAUTH.md) — 完整的 PK流程和令牌轮换 [docs/RATE_LIMITS.md](docs/RATE_LIMITS.md) — 令牌桶、每日计数器、回退
- [docs/ERROR_HANDLING.md](docs/ERROR_HANDLING.md) — 异常层次信封形状
- [docs/TESTING.md](docs/TESTING.md) — 单元和集成测试策略
- [docs/WORKFLOWS.md](docs/WORKFLOWS.md) — **仅语的端到端 LLM 工作流**
- [docs/permissions.md](docs/permissions.md) — 策略门和确认模式
- [SECURITY.md](SECURITY.md)，[PRIVACY.md](PRIVACY.md)
## 安全通知
令牌存储在本地 `~/.config/etsy-mcp/tokens.json`， `0600`。刷新令牌在每次刷新时都会轮换 — Etsy 会立即使旧令牌失效。F3 层从每行日志、错误信封和工具响应中清除 OAuth 令牌、买家 PII（`email`、`first_name`、`last_name`、`name`、`etsy_user_id`）和店铺凭证。如 [SECURITY.md](SECURITY.md) 中通过安全漏洞报告漏洞 — 绝不通过公共问题。
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING
