sellersprite-cli 0.1.0__tar.gz

sellersprite_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dual
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sellersprite_cli-0.1.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: sellersprite-cli
+Version: 0.1.0
+Summary: 卖家精灵 CLI — 交互式终端工具 + MCP 客户端 + 27 AI Skills，通过 MCP 调用 36 个 Amazon 数据工具
+License-Expression: MIT
+Project-URL: Homepage, https://www.sellersprite.com
+Project-URL: Documentation, https://mcp.sellersprite.com
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.0
+Dynamic: license-file
+
+# SellerSprite CLI
+
+卖家精灵 CLI — 交互式终端工具 + Python MCP 客户端 + 27 AI Skills，通过 MCP 调用全部 36 个 Amazon 数据工具。
+
+## 安装
+
+```bash
+pip install sellersprite-cli
+```
+
+## 配置密钥
+
+```bash
+# Linux / macOS
+export SELLERSPRITE_KEY="你的API密钥"
+
+# Windows PowerShell
+$env:SELLERSPRITE_KEY = "你的API密钥"
+```
+
+或在项目根目录创建 `.env` 文件：
+
+```
+SELLERSPRITE_KEY=你的API密钥
+```
+
+密钥在 [卖家精灵开放平台](https://open.sellersprite.com) 获取。
+
+## CLI 使用
+
+### 交互式 TUI
+
+```bash
+sellersprite               # 无参数启动交互式菜单
+```
+
+### 域命令（36 个工具）
+
+```bash
+# ASIN 分析
+sellersprite asin detail B0D6LQ5VZM
+sellersprite asin predict B0D6LQ5VZM
+sellersprite asin coupon B0D6LQ5VZM
+sellersprite asin keepa B0D6LQ5VZM
+
+# 商品与竞品
+sellersprite product search --keyword "wireless earbuds" --min-price 10 --max-price 30
+sellersprite product competitor --asins B0XXX1,B0XXX2
+sellersprite product node --keyword earbuds
+
+# 关键词
+sellersprite keyword mine --keyword earbuds --size 20
+sellersprite keyword research --keyword earbuds
+sellersprite keyword order --asins B0XXX1,B0XXX2
+sellersprite keyword bsr 10000 172282
+
+# 流量
+sellersprite traffic keyword --asin-list B0XXX1,B0XXX2
+sellersprite traffic keyword-stat B0XXX1 --month 2025-01
+sellersprite traffic source --asin B0XXX1
+sellersprite traffic listing --asin-list B0XXX1 --relations also_bought
+sellersprite traffic extend --asin-list B0XXX1
+
+# 市场分析
+sellersprite market research --keyword earbuds
+sellersprite market stats --node-id-path "172282:24046923011"
+sellersprite market price --node-id-path "172282:24046923011"
+sellersprite market brand --node-id-path "172282:24046923011"
+sellersprite market demand --node-id-path "172282:24046923011"
+# ... 共 14 个市场分析命令
+
+# ABA / 趋势
+sellersprite trend aba-weekly --keyword-list earbuds,buds
+sellersprite trend aba-monthly --keyword-list earbuds
+sellersprite trend google --keyword earbuds
+sellersprite trend review B0D6LQ5VZM
+```
+
+### 其他命令
+
+```bash
+sellersprite list                              # 列出所有 36 个工具
+sellersprite skill list                        # 列出 27 个 Skills
+sellersprite skill show --name product-research # 查看某个 Skill 内容
+
+# 生成 AI 客户端配置
+sellersprite init claude-code --skills         # Claude Code
+sellersprite init cursor --skills              # Cursor
+sellersprite init --all --skills               # 全部客户端
+sellersprite init --dry-run                    # 预览模式
+```
+
+### 全局参数
+
+| 参数 | 说明 |
+|------|------|
+| `--key, -k` | API 密钥 |
+| `--marketplace, -m` | 站点代码（默认 US） |
+
+支持站点：`US`、`JP`、`UK`、`DE`、`FR`、`IT`、`ES`、`CA`、`IN`
+
+## Python MCP 客户端
+
+```python
+from sellersprite_cli import SellerSprite
+
+ss = SellerSprite()
+
+# 搜索类目
+nodes = ss.product_node(keyword="wireless earbuds")
+
+# ASIN 详情
+detail = ss.asin_detail(asin="B0D6LQ5VZM")
+
+# 商品筛选
+result = ss.product_research(keyword="earbuds", priceMin=10, priceMax=30)
+
+# 切换站点
+ss_jp = SellerSprite(marketplace="JP")
+```
+
+## AI Skills（27 个）
+
+### 综合分析（10 个）
+
+| 命令 | 说明 |
+|------|------|
+| 智能选品助手 | 按多维条件筛选潜力商品 |
+| 市场全景分析 | 11 个维度的全方位市场评估 |
+| 竞品深度拆解 | 8 大维度全面拆解竞品 |
+| 关键词选品研究 | 基于关键词的市场需求分析 |
+| Listing 优化诊断 | 发现关键词覆盖缺口 |
+| 流量结构分析 | 拆解自然/广告/推荐流量 |
+| 蓝海机会挖掘 | 通过 ABA 趋势发现机会 |
+| 买家评论洞察 | 提炼痛点和改进方向 |
+| 定价策略分析 | 价格带分布与最优定价 |
+| 广告投放优化 | PPC 策略、竞价和否词 |
+
+### 战术选品（17 个）
+
+新品爆发、关键词趋势、产品缺陷、类目结构、流量防伪、机会捕捉
+
+通过 `sellersprite skill list` 查看完整列表。
+
+## 支持客户端
+
+`claude-code`、`cursor`、`cline`、`claude-desktop`、`vscode`、`windsurf`、`trae`、`codex`、`antigravity`、`openclaw`
+
+## 许可证
+
+[MIT License](LICENSE)

sellersprite_cli-0.1.0/README.md

@@ -0,0 +1,151 @@
+# SellerSprite CLI
+
+卖家精灵 CLI — 交互式终端工具 + Python MCP 客户端 + 27 AI Skills，通过 MCP 调用全部 36 个 Amazon 数据工具。
+
+## 安装
+
+```bash
+pip install sellersprite-cli
+```
+
+## 配置密钥
+
+```bash
+# Linux / macOS
+export SELLERSPRITE_KEY="你的API密钥"
+
+# Windows PowerShell
+$env:SELLERSPRITE_KEY = "你的API密钥"
+```
+
+或在项目根目录创建 `.env` 文件：
+
+```
+SELLERSPRITE_KEY=你的API密钥
+```
+
+密钥在 [卖家精灵开放平台](https://open.sellersprite.com) 获取。
+
+## CLI 使用
+
+### 交互式 TUI
+
+```bash
+sellersprite               # 无参数启动交互式菜单
+```
+
+### 域命令（36 个工具）
+
+```bash
+# ASIN 分析
+sellersprite asin detail B0D6LQ5VZM
+sellersprite asin predict B0D6LQ5VZM
+sellersprite asin coupon B0D6LQ5VZM
+sellersprite asin keepa B0D6LQ5VZM
+
+# 商品与竞品
+sellersprite product search --keyword "wireless earbuds" --min-price 10 --max-price 30
+sellersprite product competitor --asins B0XXX1,B0XXX2
+sellersprite product node --keyword earbuds
+
+# 关键词
+sellersprite keyword mine --keyword earbuds --size 20
+sellersprite keyword research --keyword earbuds
+sellersprite keyword order --asins B0XXX1,B0XXX2
+sellersprite keyword bsr 10000 172282
+
+# 流量
+sellersprite traffic keyword --asin-list B0XXX1,B0XXX2
+sellersprite traffic keyword-stat B0XXX1 --month 2025-01
+sellersprite traffic source --asin B0XXX1
+sellersprite traffic listing --asin-list B0XXX1 --relations also_bought
+sellersprite traffic extend --asin-list B0XXX1
+
+# 市场分析
+sellersprite market research --keyword earbuds
+sellersprite market stats --node-id-path "172282:24046923011"
+sellersprite market price --node-id-path "172282:24046923011"
+sellersprite market brand --node-id-path "172282:24046923011"
+sellersprite market demand --node-id-path "172282:24046923011"
+# ... 共 14 个市场分析命令
+
+# ABA / 趋势
+sellersprite trend aba-weekly --keyword-list earbuds,buds
+sellersprite trend aba-monthly --keyword-list earbuds
+sellersprite trend google --keyword earbuds
+sellersprite trend review B0D6LQ5VZM
+```
+
+### 其他命令
+
+```bash
+sellersprite list                              # 列出所有 36 个工具
+sellersprite skill list                        # 列出 27 个 Skills
+sellersprite skill show --name product-research # 查看某个 Skill 内容
+
+# 生成 AI 客户端配置
+sellersprite init claude-code --skills         # Claude Code
+sellersprite init cursor --skills              # Cursor
+sellersprite init --all --skills               # 全部客户端
+sellersprite init --dry-run                    # 预览模式
+```
+
+### 全局参数
+
+| 参数 | 说明 |
+|------|------|
+| `--key, -k` | API 密钥 |
+| `--marketplace, -m` | 站点代码（默认 US） |
+
+支持站点：`US`、`JP`、`UK`、`DE`、`FR`、`IT`、`ES`、`CA`、`IN`
+
+## Python MCP 客户端
+
+```python
+from sellersprite_cli import SellerSprite
+
+ss = SellerSprite()
+
+# 搜索类目
+nodes = ss.product_node(keyword="wireless earbuds")
+
+# ASIN 详情
+detail = ss.asin_detail(asin="B0D6LQ5VZM")
+
+# 商品筛选
+result = ss.product_research(keyword="earbuds", priceMin=10, priceMax=30)
+
+# 切换站点
+ss_jp = SellerSprite(marketplace="JP")
+```
+
+## AI Skills（27 个）
+
+### 综合分析（10 个）
+
+| 命令 | 说明 |
+|------|------|
+| 智能选品助手 | 按多维条件筛选潜力商品 |
+| 市场全景分析 | 11 个维度的全方位市场评估 |
+| 竞品深度拆解 | 8 大维度全面拆解竞品 |
+| 关键词选品研究 | 基于关键词的市场需求分析 |
+| Listing 优化诊断 | 发现关键词覆盖缺口 |
+| 流量结构分析 | 拆解自然/广告/推荐流量 |
+| 蓝海机会挖掘 | 通过 ABA 趋势发现机会 |
+| 买家评论洞察 | 提炼痛点和改进方向 |
+| 定价策略分析 | 价格带分布与最优定价 |
+| 广告投放优化 | PPC 策略、竞价和否词 |
+
+### 战术选品（17 个）
+
+新品爆发、关键词趋势、产品缺陷、类目结构、流量防伪、机会捕捉
+
+通过 `sellersprite skill list` 查看完整列表。
+
+## 支持客户端
+
+`claude-code`、`cursor`、`cline`、`claude-desktop`、`vscode`、`windsurf`、`trae`、`codex`、`antigravity`、`openclaw`
+
+## 许可证
+
+[MIT License](LICENSE)

sellersprite_cli-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sellersprite-cli"
+version = "0.1.0"
+description = "卖家精灵 CLI — 交互式终端工具 + MCP 客户端 + 27 AI Skills，通过 MCP 调用 36 个 Amazon 数据工具"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.28",
+    "typer>=0.12",
+    "rich>=13.0",
+]
+
+[project.scripts]
+sellersprite = "sellersprite_cli.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["sellersprite_cli*"]
+
+[tool.setuptools.package-data]
+sellersprite_cli = ["skills/**/*"]
+
+[project.urls]
+Homepage = "https://www.sellersprite.com"
+Documentation = "https://mcp.sellersprite.com"

sellersprite_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sellersprite_cli-0.1.0/src/sellersprite_cli/__init__.py

@@ -0,0 +1,8 @@
+"""卖家精灵 CLI — Python MCP 客户端 + 交互式终端 + 27 AI Skills."""
+
+from importlib.metadata import version as _version
+
+__version__ = _version("sellersprite-cli")
+
+from .mcp_client import SellerSprite
+from .errors import ApiError, McpError