Metadata-Version: 2.4
Name: proboost-cli
Version: 0.1.0
Summary: Unified CLI and Python client for Proboost TikTok, Patent, and Amazon MCP servers.
Author: Proboost CLI
License-Expression: MIT
Keywords: mcp,cli,proboost,tiktok,patent,amazon
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.24
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: twine>=6.0; extra == "dev"
Dynamic: license-file

# proboost-cli

统一 Proboost MCP 命令行工具，包含 TikTok、Patent、Amazon 三套 MCP 的交互式菜单、快捷命令、通用调用和 Python 客户端。

## 安装

从 PyPI 安装：

```bash
pip install proboost-cli
```

开发安装：

```bash
python3.12 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e ".[dev]"
```

安装后命令为：

```bash
proboost --help
```

## 配置密钥

三套 MCP 共用同一个密钥时：

```bash
proboost config set --secret-key "你的密钥"
```

也可以只配置某一个 MCP：

```bash
proboost config set --mcp patent --secret-key "你的密钥"
proboost config set --mcp amazon --base-url "http://mcp.microdata-inc.com/mcp-servers/proboost-amazon-mcp"
```

环境变量也支持：

```bash
export PROBOOST_SECRET_KEY="通用密钥"
export PROBOOST_TIKTOK_SECRET_KEY="TikTok 专用密钥"
export PROBOOST_PATENT_SECRET_KEY="Patent 专用密钥"
export PROBOOST_AMAZON_SECRET_KEY="Amazon 专用密钥"
```

## 通用命令

```bash
proboost                 # 交互式菜单
proboost list            # 列出全部 55 个工具
proboost docs patent patent_query_search

proboost call tiktok tt_video_content \
  --set countryRegion=美国 \
  --set videoId=7587942790298979614

proboost call patent patent_query_count \
  --set query_text="TACD: virtual reality"

proboost call amazon amz_product_selection \
  --set webSiteId=1 \
  --set pages=1 \
  --set pagesSize=10
```

## 快捷命令示例

TikTok：

```bash
proboost tiktok commodity category-tree
proboost tiktok video content 7587942790298979614 --country 美国
proboost tiktok shop list --data-period last30d --country 美国
```

Patent：

```bash
proboost patent search count "TACD: virtual reality"
proboost patent search query "TACD: virtual reality" --limit 10
proboost patent detail bibliography --patent-number US11205304B2
proboost patent image-search single "https://example.com/image.jpg" --model 1 --patent-type D
```

Amazon：

```bash
proboost amazon product selection --site 1 --pages 1 --pages-size 10
proboost amazon product sku B0EXAMPLE --site 1
proboost amazon hot cat-tree --site 1 --rank-type "Best Seller"
```

复杂筛选条件可追加 `key=value`：

```bash
proboost amazon product selection --site 1 minPrice=10 maxPrice=30 sortField=sku_sales_last_30d sortOrder=desc
```

## Python 客户端

```python
from proboost_cli import Proboost

pb = Proboost()
content = pb.tiktok.tt_video_content(countryRegion="美国", videoId="7587942790298979614")
count = pb.patent.patent_query_count(query_text="TACD: virtual reality")
items = pb.amazon.amz_product_selection(webSiteId="1", pages=1, pagesSize=10)
```

## 测试

```bash
python -m pytest
proboost --help
proboost list
```
