openboost-cli 1.0.1__tar.gz → 2.0.0__tar.gz

openboost_cli-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenBoost CLI contributors
+
+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.

openboost_cli-2.0.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: openboost-cli
+Version: 2.0.0
+Summary: Unified CLI and Python client for OpenBoost TikTok, Patent, and Amazon MCP servers.
+Author: OpenBoost CLI
+License-Expression: MIT
+Keywords: mcp,cli,openboost,tiktok,patent,amazon
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2,>=1.24
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Dynamic: license-file
+
+# openboost-cli
+
+OpenBoost MCP 的统一命令行工具和 Python 客户端，支持 TikTok、Patent 和 Amazon 三类 MCP 服务。
+
+- PyPI 包名：`openboost-cli`
+- 命令行入口：`openboost`
+- Python 包名：`openboost_cli`
+- Python 版本：3.10 及以上
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+pip install openboost-cli
+```
+
+从源码使用 uv 安装开发环境：
+
+```bash
+uv sync
+uv run openboost --help
+```
+
+## 配置
+
+可以将通用密钥写入配置文件：
+
+```bash
+openboost config set --secret-key "your-secret-key"
+```
+
+也可以只配置某个 MCP：
+
+```bash
+openboost config set --mcp amazon --secret-key "your-secret-key"
+openboost config set --mcp amazon --base-url "http://mcp.microdata-inc.com/mcp-servers/proboost-amazon-mcp"
+```
+
+默认配置文件位于：
+
+```text
+~/.config/openboost/config.json
+```
+
+支持以下环境变量：
+
+```text
+OPENBOOST_CONFIG
+OPENBOOST_SECRET_KEY
+OPENBOOST_TIKTOK_SECRET_KEY
+OPENBOOST_PATENT_SECRET_KEY
+OPENBOOST_AMAZON_SECRET_KEY
+OPENBOOST_TIKTOK_BASE_URL
+OPENBOOST_PATENT_BASE_URL
+OPENBOOST_AMAZON_BASE_URL
+```
+
+密钥也可仅对一次调用通过顶层 `--key` 参数提供。不要将密钥提交到代码仓库。
+
+## 命令行使用
+
+查看帮助和全部工具：
+
+```bash
+openboost --help
+openboost list
+```
+
+查看某个工具的参数：
+
+```bash
+openboost docs tiktok tt_commodity_info_list
+```
+
+使用快捷命令：
+
+```bash
+openboost tiktok commodity category-tree
+openboost patent search count "TACD: virtual reality"
+openboost amazon hot cat-tree --site 1 --rank-type "Best Seller"
+```
+
+使用通用调用命令：
+
+```bash
+openboost call tiktok tt_video_content \
+  --set countryRegion=美国 \
+  --set videoId=123456
+```
+
+复杂参数可以从 JSON 文件或标准输入读取：
+
+```bash
+openboost call patent patent_query_search --payload request.json
+echo '{"query_text":"TACD: virtual reality","limit":10}' | \
+  openboost call patent patent_query_search --stdin
+```
+
+不带子命令运行 `openboost` 会进入交互式菜单，也可以显式运行：
+
+```bash
+openboost tui
+```
+
+## Python 客户端
+
+Python 客户端按 MCP 分类提供动态工具方法，方法名与 MCP tool name 保持一致：
+
+```python
+from openboost_cli import OpenBoost
+
+client = OpenBoost(secret_key="your-secret-key")
+
+result = client.tiktok.tt_video_content(
+    countryRegion="美国",
+    videoId="123456",
+)
+
+patents = client.patent.patent_query_search(
+    query_text="TACD: virtual reality",
+    limit=10,
+)
+```
+
+也可以按名称取得某个 MCP 客户端：
+
+```python
+tiktok = client.client("tiktok")
+result = tiktok.call_tool(
+    "tt_commodity_get_commodity_cat_tree",
+    {},
+)
+```
+
+## 开发与构建
+
+```bash
+uv sync
+uv run pytest
+uv build
+```
+
+单元测试不会访问真实接口。真实接口 smoke test 必须同时显式设置开关和密钥：
+
+```bash
+OPENBOOST_RUN_INTEGRATION=1 \
+OPENBOOST_TIKTOK_SECRET_KEY="your-secret-key" \
+uv run pytest -m integration
+```
+
+项目不会自动发布到 PyPI；发布前请人工检查构建产物和版本号。

openboost_cli-2.0.0/README.md

@@ -0,0 +1,152 @@
+# openboost-cli
+
+OpenBoost MCP 的统一命令行工具和 Python 客户端，支持 TikTok、Patent 和 Amazon 三类 MCP 服务。
+
+- PyPI 包名：`openboost-cli`
+- 命令行入口：`openboost`
+- Python 包名：`openboost_cli`
+- Python 版本：3.10 及以上
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+pip install openboost-cli
+```
+
+从源码使用 uv 安装开发环境：
+
+```bash
+uv sync
+uv run openboost --help
+```
+
+## 配置
+
+可以将通用密钥写入配置文件：
+
+```bash
+openboost config set --secret-key "your-secret-key"
+```
+
+也可以只配置某个 MCP：
+
+```bash
+openboost config set --mcp amazon --secret-key "your-secret-key"
+openboost config set --mcp amazon --base-url "http://mcp.microdata-inc.com/mcp-servers/proboost-amazon-mcp"
+```
+
+默认配置文件位于：
+
+```text
+~/.config/openboost/config.json
+```
+
+支持以下环境变量：
+
+```text
+OPENBOOST_CONFIG
+OPENBOOST_SECRET_KEY
+OPENBOOST_TIKTOK_SECRET_KEY
+OPENBOOST_PATENT_SECRET_KEY
+OPENBOOST_AMAZON_SECRET_KEY
+OPENBOOST_TIKTOK_BASE_URL
+OPENBOOST_PATENT_BASE_URL
+OPENBOOST_AMAZON_BASE_URL
+```
+
+密钥也可仅对一次调用通过顶层 `--key` 参数提供。不要将密钥提交到代码仓库。
+
+## 命令行使用
+
+查看帮助和全部工具：
+
+```bash
+openboost --help
+openboost list
+```
+
+查看某个工具的参数：
+
+```bash
+openboost docs tiktok tt_commodity_info_list
+```
+
+使用快捷命令：
+
+```bash
+openboost tiktok commodity category-tree
+openboost patent search count "TACD: virtual reality"
+openboost amazon hot cat-tree --site 1 --rank-type "Best Seller"
+```
+
+使用通用调用命令：
+
+```bash
+openboost call tiktok tt_video_content \
+  --set countryRegion=美国 \
+  --set videoId=123456
+```
+
+复杂参数可以从 JSON 文件或标准输入读取：
+
+```bash
+openboost call patent patent_query_search --payload request.json
+echo '{"query_text":"TACD: virtual reality","limit":10}' | \
+  openboost call patent patent_query_search --stdin
+```
+
+不带子命令运行 `openboost` 会进入交互式菜单，也可以显式运行：
+
+```bash
+openboost tui
+```
+
+## Python 客户端
+
+Python 客户端按 MCP 分类提供动态工具方法，方法名与 MCP tool name 保持一致：
+
+```python
+from openboost_cli import OpenBoost
+
+client = OpenBoost(secret_key="your-secret-key")
+
+result = client.tiktok.tt_video_content(
+    countryRegion="美国",
+    videoId="123456",
+)
+
+patents = client.patent.patent_query_search(
+    query_text="TACD: virtual reality",
+    limit=10,
+)
+```
+
+也可以按名称取得某个 MCP 客户端：
+
+```python
+tiktok = client.client("tiktok")
+result = tiktok.call_tool(
+    "tt_commodity_get_commodity_cat_tree",
+    {},
+)
+```
+
+## 开发与构建
+
+```bash
+uv sync
+uv run pytest
+uv build
+```
+
+单元测试不会访问真实接口。真实接口 smoke test 必须同时显式设置开关和密钥：
+
+```bash
+OPENBOOST_RUN_INTEGRATION=1 \
+OPENBOOST_TIKTOK_SECRET_KEY="your-secret-key" \
+uv run pytest -m integration
+```
+
+项目不会自动发布到 PyPI；发布前请人工检查构建产物和版本号。

{openboost_cli-1.0.1 → openboost_cli-2.0.0}/pyproject.toml

@@ -1,51 +1,54 @@
-[build-system]
-requires = ["setuptools>=61"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "openboost-cli"
-description = "Unified CLI and Python client for Openboost TikTok, Patent, and Amazon MCP servers."
-readme = "README.md"
-requires-python = ">=3.10"
-license = { text = "MIT" }
-authors = [{ name = "Openboost CLI" }]
-keywords = ["mcp", "cli", "openboost", "proboost", "tiktok", "patent", "amazon"]
-classifiers = [
-  "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12",
-  "Environment :: Console",
-]
-dynamic = ["version"]
-dependencies = [
-  "httpx>=0.27",
-  "mcp>=1.24",
-  "rich>=13.0",
-  "typer>=0.12",
-]
-
-[project.optional-dependencies]
-dev = ["pytest>=8"]
-
-[project.scripts]
-openboost = "openboost_cli.cli.main:main"
-
-[tool.setuptools]
-package-dir = { "" = "src" }
-
-[tool.setuptools.packages.find]
-where = ["src"]
-
-[tool.setuptools.package-data]
-openboost_cli = [
-  "schemas/tiktok/*.json",
-  "schemas/patent/*.json",
-  "schemas/amazon/*.json",
-]
-
-[tool.setuptools.dynamic]
-version = { attr = "openboost_cli.__version__" }
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "openboost-cli"
+version = "2.0.0"
+description = "Unified CLI and Python client for OpenBoost TikTok, Patent, and Amazon MCP servers."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "OpenBoost CLI" },
+]
+keywords = ["mcp", "cli", "openboost", "tiktok", "patent", "amazon"]
+classifiers = [
+  "Environment :: Console",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+  "httpx>=0.27",
+  "mcp>=1.24,<2",
+  "rich>=13.0",
+  "typer>=0.12",
+]
+
+[project.scripts]
+openboost = "openboost_cli.cli.main:main"
+
+[dependency-groups]
+dev = [
+  "pytest>=8",
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = false
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+openboost_cli = ["schemas/*/*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+  "integration: tests that call a live OpenBoost MCP endpoint",
+]

{openboost_cli-1.0.1 → openboost_cli-2.0.0}/setup.cfg

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

{openboost_cli-1.0.1 → openboost_cli-2.0.0}/src/openboost_cli/__init__.py

@@ -1,21 +1,21 @@
-"""Unified Openboost MCP CLI and Python client."""
-
-__version__ = "1.0.1"
-
-DEFAULT_BASE_URLS = {
-    "tiktok": "http://mcp.microdata-inc.com/mcp-servers/proboost-tiktok-mcp",
-    "patent": "http://mcp.microdata-inc.com/mcp-servers/proboost-patent-mcp",
-    "amazon": "http://mcp.microdata-inc.com/mcp-servers/proboost-amazon-mcp",
-}
-
-MCP_LABELS = {
-    "tiktok": "TikTok",
-    "patent": "Patent",
-    "amazon": "Amazon",
-}
-
-MCP_NAMES = tuple(DEFAULT_BASE_URLS.keys())
-
-from .client import Openboost
-
-__all__ = ["DEFAULT_BASE_URLS", "MCP_LABELS", "MCP_NAMES", "Openboost", "__version__"]
+"""Unified OpenBoost MCP CLI and Python client."""
+
+__version__ = "2.0.0"
+
+DEFAULT_BASE_URLS = {
+    "tiktok": "http://mcp.microdata-inc.com/mcp-servers/proboost-tiktok-mcp",
+    "patent": "http://mcp.microdata-inc.com/mcp-servers/proboost-patent-mcp",
+    "amazon": "http://mcp.microdata-inc.com/mcp-servers/proboost-amazon-mcp",
+}
+
+MCP_LABELS = {
+    "tiktok": "TikTok",
+    "patent": "Patent",
+    "amazon": "Amazon",
+}
+
+MCP_NAMES = tuple(DEFAULT_BASE_URLS.keys())
+
+from .client import OpenBoost
+
+__all__ = ["DEFAULT_BASE_URLS", "MCP_LABELS", "MCP_NAMES", "OpenBoost", "__version__"]

{openboost_cli-1.0.1 → openboost_cli-2.0.0}/src/openboost_cli/cli/__init__.py

@@ -1 +1 @@
-"""CLI entry points."""
+"""CLI entry points."""