openboost-cli 0.1.0__py3-none-any.whl

proboost_cli/schemas/tiktok/tt_video_info_list.json

@@ -0,0 +1,152 @@
+{
+  "name": "tt_video_info_list",
+  "description": "分页查询 TT 视频选品列表，支持国家/地区、标题与达人/商品/店铺、发布时间、播放互动、近30日销量与 GMV、投流与带货类型、数据维度与销量口径、总结/脚本标记等筛选与排序。；无「查看全部」权限时仅可查询前 3 页；每页最多 30 条。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "adSource": {
+        "description": "是否投流：0 否 / 1 是",
+        "type": "integer"
+      },
+      "commodityId": {
+        "description": "商品编号",
+        "type": "string"
+      },
+      "countryRegion": {
+        "description": "国家/地区，与站内选品一致；paramCheck 要求非空",
+        "type": "string"
+      },
+      "current": {
+        "description": "当前页码，默认 1；无「查看全部」权限时 current > 3 会报错",
+        "type": "integer"
+      },
+      "dataPeriod": {
+        "description": "数据维度，与 date 等联用",
+        "type": "string"
+      },
+      "date": {
+        "description": "数据日期，ISO 8601 日期时间字符串",
+        "type": "string"
+      },
+      "expertId": {
+        "description": "达人编号",
+        "type": "string"
+      },
+      "expertName": {
+        "description": "达人名称/昵称筛选",
+        "type": "string"
+      },
+      "fansNumberEnd": {
+        "description": "粉丝数区间上限",
+        "type": "integer"
+      },
+      "fansNumberStart": {
+        "description": "粉丝数区间下限",
+        "type": "integer"
+      },
+      "gmvLast30dEnd": {
+        "description": "近30天销售额区间上限",
+        "type": "integer"
+      },
+      "gmvLast30dStart": {
+        "description": "近30天销售额区间下限（与接口数值口径一致）",
+        "type": "integer"
+      },
+      "hasVideoScript": {
+        "description": "是否有视频脚本",
+        "type": "string"
+      },
+      "hasVideoSummary": {
+        "description": "是否有视频总结（与站内标记一致）",
+        "type": "string"
+      },
+      "hasVoiceSummary": {
+        "description": "是否有评论总结",
+        "type": "string"
+      },
+      "interactionRateEnd": {
+        "description": "互动率区间上限（百分比口径）",
+        "type": "string"
+      },
+      "interactionRateStart": {
+        "description": "互动率区间下限（百分比口径，与前端一致）",
+        "type": "string"
+      },
+      "likeNumberEnd": {
+        "description": "点赞数区间上限",
+        "type": "integer"
+      },
+      "likeNumberStart": {
+        "description": "点赞数区间下限",
+        "type": "integer"
+      },
+      "mainCategory": {
+        "description": "主营类目",
+        "type": "string"
+      },
+      "offset": {
+        "description": "偏移量，可选",
+        "type": "integer"
+      },
+      "orderType": {
+        "description": "排序类型，如 playNumberDesc（默认播放量降序）、publishTimeDesc 等，完整见 VideoInfoRequest 注释",
+        "type": "string"
+      },
+      "playNumberEnd": {
+        "description": "播放量区间上限",
+        "type": "integer"
+      },
+      "playNumberStart": {
+        "description": "播放量区间下限",
+        "type": "integer"
+      },
+      "publishTimeEnd": {
+        "description": "发布日期止，yyyy-MM-dd（GMT+8）",
+        "type": "string"
+      },
+      "publishTimeStart": {
+        "description": "发布日期起，yyyy-MM-dd（GMT+8）",
+        "type": "string"
+      },
+      "reviewsNumberEnd": {
+        "description": "评论数区间上限",
+        "type": "integer"
+      },
+      "reviewsNumberStart": {
+        "description": "评论数区间下限",
+        "type": "integer"
+      },
+      "salesPeriod": {
+        "description": "销量口径：day / last7Day / last30Day 等",
+        "type": "string"
+      },
+      "shopId": {
+        "description": "店铺 ID",
+        "type": "string"
+      },
+      "size": {
+        "description": "每页条数，默认 10，最大 30（paramPageListCheck）",
+        "type": "integer"
+      },
+      "soldLast30dEnd": {
+        "description": "近30天销量区间上限",
+        "type": "integer"
+      },
+      "soldLast30dStart": {
+        "description": "近30天销量区间下限",
+        "type": "integer"
+      },
+      "videoTitle": {
+        "description": "视频标题关键词，空格分词",
+        "type": "string"
+      },
+      "videoType": {
+        "description": "视频类型，如 powerVideo 带货视频",
+        "type": "string"
+      }
+    },
+    "required": [
+      "countryRegion"
+    ]
+  }
+}

proboost_cli/schemas/tiktok/tt_video_new_video_summary.json

@@ -0,0 +1,20 @@
+{
+  "name": "tt_video_new_video_summary",
+  "description": "按视频 ID 查询新版视频总结（结构化列表）。；data 为 Map 列表，键值以实际联调为准。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "countryRegion": {
+        "description": "国家/地区；请求体字段与 VideoDetailRequest 一致，当前实现仅将 videoId 传入业务",
+        "type": "string"
+      },
+      "videoId": {
+        "description": "视频编号；paramCheck 要求非空",
+        "type": "string"
+      }
+    },
+    "required": [
+      "videoId"
+    ]
+  }
+}

proboost_cli/schemas/tiktok/tt_video_script_diy_query.json

@@ -0,0 +1,20 @@
+{
+  "name": "tt_video_script_diy_query",
+  "description": "查询当前用户在某视频下的 DIY 脚本列表及是否完成。；口播原文为空时直接返回空的 VideoScriptDiyResponse（成功）。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "countryRegion": {
+        "description": "国家/地区；VideoDetailRequest 字段；本接口查询 DIY 脚本时未传入 getVideoContent 的 VideoDTO（仅按 videoId 拉口播），可忽略或与站内保持一致传入",
+        "type": "string"
+      },
+      "videoId": {
+        "description": "视频编号；paramCheck 要求非空",
+        "type": "string"
+      }
+    },
+    "required": [
+      "videoId"
+    ]
+  }
+}

proboost_cli/schemas/tiktok/tt_video_voice_read.json

@@ -0,0 +1,28 @@
+{
+  "name": "tt_video_voice_read",
+  "description": "分页查询视频评论（含子回复列表）。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "countryRegion": {
+        "description": "国家/地区；传入 VideoDTO.countryRegion",
+        "type": "string"
+      },
+      "current": {
+        "description": "当前页码，默认 1",
+        "type": "integer"
+      },
+      "size": {
+        "description": "每页条数，默认 10；paramCheck 仅限制 size 不大于 1000（未使用 pbParamCheck，无 30 条上限）",
+        "type": "integer"
+      },
+      "videoId": {
+        "description": "视频编号；paramCheck 要求非空",
+        "type": "string"
+      }
+    },
+    "required": [
+      "videoId"
+    ]
+  }
+}

proboost_cli/schemas/tiktok/tt_video_voice_summary.json

@@ -0,0 +1,28 @@
+{
+  "name": "tt_video_voice_summary",
+  "description": "查询视频评论总结模块：采集/总结进度（not_grip / gripping / gripped 等）与结构化总结列表（标题 + 描述条目）。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "countryRegion": {
+        "description": "国家/地区；传入 VideoDTO.countryRegion",
+        "type": "string"
+      },
+      "current": {
+        "description": "当前页码，默认 1（Pagination；本接口为单视频总结，一般可不翻页）",
+        "type": "integer"
+      },
+      "size": {
+        "description": "每页条数，默认 10，最大 30（pbParamCheck）",
+        "type": "integer"
+      },
+      "videoId": {
+        "description": "视频编号；paramCheck 要求非空",
+        "type": "string"
+      }
+    },
+    "required": [
+      "videoId"
+    ]
+  }
+}

proboost_cli/schemas_loader.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import json
+from importlib import resources
+from typing import Any
+
+from proboost_cli import MCP_NAMES
+
+
+def _tools_pkg(mcp: str) -> str:
+    if mcp not in MCP_NAMES:
+        raise ValueError(f"Unknown MCP: {mcp}")
+    return f"proboost_cli.schemas.{mcp}"
+
+
+def iter_tool_manifests(mcp: str) -> list[tuple[str, dict[str, Any]]]:
+    root = resources.files(_tools_pkg(mcp))
+    items: list[tuple[str, dict[str, Any]]] = []
+    for item in sorted(root.iterdir(), key=lambda p: p.name):
+        if not item.is_file() or not item.name.endswith(".json"):
+            continue
+        raw = json.loads(item.read_bytes().decode("utf-8"))
+        name = raw.get("name")
+        if isinstance(name, str):
+            items.append((name, raw))
+    return items
+
+
+def load_tool_definitions(mcp: str) -> dict[str, dict[str, Any]]:
+    return dict(iter_tool_manifests(mcp))
+
+
+def load_all_tool_definitions() -> dict[str, dict[str, dict[str, Any]]]:
+    return {mcp: load_tool_definitions(mcp) for mcp in MCP_NAMES}
+
+
+def tool_schema_arguments(tool: dict[str, Any]) -> dict[str, Any]:
+    args = tool.get("arguments")
+    return args if isinstance(args, dict) else {}
+
+
+def tool_schema_properties(tool: dict[str, Any]) -> dict[str, Any]:
+    props = tool_schema_arguments(tool).get("properties")
+    return props if isinstance(props, dict) else {}
+
+
+def tool_schema_required(tool: dict[str, Any]) -> list[str]:
+    req = tool_schema_arguments(tool).get("required")
+    return list(req) if isinstance(req, list) else []