openboost-cli 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. openboost_cli-0.1.0.dist-info/METADATA +153 -0
  2. openboost_cli-0.1.0.dist-info/RECORD +76 -0
  3. openboost_cli-0.1.0.dist-info/WHEEL +5 -0
  4. openboost_cli-0.1.0.dist-info/entry_points.txt +2 -0
  5. openboost_cli-0.1.0.dist-info/licenses/LICENSE +21 -0
  6. openboost_cli-0.1.0.dist-info/top_level.txt +1 -0
  7. proboost_cli/__init__.py +21 -0
  8. proboost_cli/cli/__init__.py +1 -0
  9. proboost_cli/cli/interactive.py +107 -0
  10. proboost_cli/cli/main.py +566 -0
  11. proboost_cli/client.py +58 -0
  12. proboost_cli/coerce_args.py +62 -0
  13. proboost_cli/config.py +109 -0
  14. proboost_cli/mcp_client.py +113 -0
  15. proboost_cli/parse_result.py +53 -0
  16. proboost_cli/registry.py +112 -0
  17. proboost_cli/schemas/__init__.py +1 -0
  18. proboost_cli/schemas/amazon/__init__.py +1 -0
  19. proboost_cli/schemas/amazon/amz_category_query.json +20 -0
  20. proboost_cli/schemas/amazon/amz_hot_amz_hot_cat_tree.json +25 -0
  21. proboost_cli/schemas/amazon/amz_hot_amz_hot_list.json +33 -0
  22. proboost_cli/schemas/amazon/amz_market_price.json +28 -0
  23. proboost_cli/schemas/amazon/amz_product_selection.json +140 -0
  24. proboost_cli/schemas/amazon/amz_review_query.json +28 -0
  25. proboost_cli/schemas/amazon/amz_sales_query.json +20 -0
  26. proboost_cli/schemas/amazon/amz_sku_query.json +20 -0
  27. proboost_cli/schemas/patent/__init__.py +1 -0
  28. proboost_cli/schemas/patent/patent_abstract_image.json +17 -0
  29. proboost_cli/schemas/patent/patent_abstract_translated.json +28 -0
  30. proboost_cli/schemas/patent/patent_bibliography.json +17 -0
  31. proboost_cli/schemas/patent/patent_claim_data.json +21 -0
  32. proboost_cli/schemas/patent/patent_claim_translated.json +28 -0
  33. proboost_cli/schemas/patent/patent_description.json +21 -0
  34. proboost_cli/schemas/patent/patent_description_translated.json +28 -0
  35. proboost_cli/schemas/patent/patent_family.json +17 -0
  36. proboost_cli/schemas/patent/patent_fulltext_image.json +29 -0
  37. proboost_cli/schemas/patent/patent_image_search_multiple.json +117 -0
  38. proboost_cli/schemas/patent/patent_image_search_single.json +114 -0
  39. proboost_cli/schemas/patent/patent_legal_status.json +17 -0
  40. proboost_cli/schemas/patent/patent_pdf.json +21 -0
  41. proboost_cli/schemas/patent/patent_query_count.json +36 -0
  42. proboost_cli/schemas/patent/patent_query_search.json +40 -0
  43. proboost_cli/schemas/patent/patent_query_search_with_agg.json +55 -0
  44. proboost_cli/schemas/patent/patent_semantic_search.json +48 -0
  45. proboost_cli/schemas/tiktok/__init__.py +1 -0
  46. proboost_cli/schemas/tiktok/tk_expert_sale_show.json +20 -0
  47. proboost_cli/schemas/tiktok/tt_commodity_detail.json +21 -0
  48. proboost_cli/schemas/tiktok/tt_commodity_expert_draw_expert_trend.json +20 -0
  49. proboost_cli/schemas/tiktok/tt_commodity_get_commodity_cat_tree.json +8 -0
  50. proboost_cli/schemas/tiktok/tt_commodity_info_list.json +180 -0
  51. proboost_cli/schemas/tiktok/tt_commodity_sales_trend.json +33 -0
  52. proboost_cli/schemas/tiktok/tt_commodity_statistics_get_category_statistics.json +28 -0
  53. proboost_cli/schemas/tiktok/tt_commodity_statistics_get_expert_statistics.json +28 -0
  54. proboost_cli/schemas/tiktok/tt_commodity_statistics_get_price_statistics.json +28 -0
  55. proboost_cli/schemas/tiktok/tt_commodity_statistics_get_total_statistics.json +28 -0
  56. proboost_cli/schemas/tiktok/tt_commodity_voice_analyze.json +36 -0
  57. proboost_cli/schemas/tiktok/tt_expert_basic_analyze.json +24 -0
  58. proboost_cli/schemas/tiktok/tt_expert_category_analyze.json +29 -0
  59. proboost_cli/schemas/tiktok/tt_expert_detail.json +20 -0
  60. proboost_cli/schemas/tiktok/tt_expert_fans_analyze.json +20 -0
  61. proboost_cli/schemas/tiktok/tt_expert_fans_portrait.json +20 -0
  62. proboost_cli/schemas/tiktok/tt_expert_info_list.json +180 -0
  63. proboost_cli/schemas/tiktok/tt_sale_channel_sale_channel.json +26 -0
  64. proboost_cli/schemas/tiktok/tt_shop_commodity_account_list.json +28 -0
  65. proboost_cli/schemas/tiktok/tt_shop_detail.json +28 -0
  66. proboost_cli/schemas/tiktok/tt_shop_info_list.json +108 -0
  67. proboost_cli/schemas/tiktok/tt_shop_market_info.json +28 -0
  68. proboost_cli/schemas/tiktok/tt_shop_sales_trend.json +33 -0
  69. proboost_cli/schemas/tiktok/tt_video_content.json +20 -0
  70. proboost_cli/schemas/tiktok/tt_video_detail.json +20 -0
  71. proboost_cli/schemas/tiktok/tt_video_info_list.json +152 -0
  72. proboost_cli/schemas/tiktok/tt_video_new_video_summary.json +20 -0
  73. proboost_cli/schemas/tiktok/tt_video_script_diy_query.json +20 -0
  74. proboost_cli/schemas/tiktok/tt_video_voice_read.json +28 -0
  75. proboost_cli/schemas/tiktok/tt_video_voice_summary.json +28 -0
  76. proboost_cli/schemas_loader.py +49 -0
@@ -0,0 +1,17 @@
1
+ {
2
+ "name": "patent_legal_status",
3
+ "description": "查询专利法律状态:返回每条专利的法律事件(event_status)、法律状态(legal_status)、简单法律状态(simple_legal_status)及状态更新日期。patent_id 与 patent_number 至少传其一;支持批量,逗号分隔最多 100 条。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "patent_id": {
8
+ "description": "专利 ID;与 patent_number 至少填其一,同时填写时优先使用。批量时多个 ID 用英文逗号分隔,≤100 条",
9
+ "type": "string"
10
+ },
11
+ "patent_number": {
12
+ "description": "公开(公告)号;批量规则同 patent_id",
13
+ "type": "string"
14
+ }
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "name": "patent_pdf",
3
+ "description": "查询专利 PDF 全文下载地址:返回每条专利的 PDF 路径(data[].pdf.path)。patent_id 与 patent_number 至少传其一;replace_by_related=1 时无 PDF 则使用同族替代;支持批量,逗号分隔最多 100 条。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "patent_id": {
8
+ "description": "专利 ID;与 patent_number 至少填其一。批量时多个 ID 用英文逗号分隔,≤100 条",
9
+ "type": "string"
10
+ },
11
+ "patent_number": {
12
+ "description": "公开(公告)号;批量规则同 patent_id",
13
+ "type": "string"
14
+ },
15
+ "replace_by_related": {
16
+ "description": "无数据时是否用同族替代:1=是,0=否(默认)",
17
+ "type": "integer"
18
+ }
19
+ }
20
+ }
21
+ }
@@ -0,0 +1,36 @@
1
+ {
2
+ "name": "patent_query_count",
3
+ "description": "检索式统计专利量:根据 Analytics 检索式返回命中专利总数(data.total_search_result_count),不返回专利列表。可配合去重参数(collapse_type/collapse_by/collapse_order)获取去重后数量。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "collapse_by": {
8
+ "description": "去重内部排序字段:APD 申请日 / PBD 公开日 / AUTHORITY 受理局 / SCORE 相关度",
9
+ "type": "string"
10
+ },
11
+ "collapse_order": {
12
+ "description": "去重排序方向(collapse_by 为 APD/PBD 时有效):OLDEST / LATEST",
13
+ "type": "string"
14
+ },
15
+ "collapse_order_authority": {
16
+ "description": "受理局优先级(collapse_by=AUTHORITY 时有效),国家代码 JSON 数组字符串,如 [\"CN\",\"US\",\"EP\"]",
17
+ "type": "string"
18
+ },
19
+ "collapse_type": {
20
+ "description": "去重口径:ALL=不去重;APNO=按申请号;DOCDB=简单同族;INPADOC=INPADOC 同族;EXTEND=扩展同族",
21
+ "type": "string"
22
+ },
23
+ "query_text": {
24
+ "description": "Analytics 检索式,最大 3000 字符;示例:TACD: virtual reality",
25
+ "type": "string"
26
+ },
27
+ "stemming": {
28
+ "description": "词干化:1=开启,0=关闭(默认);开启时英文关键词匹配时态/单复数变体",
29
+ "type": "integer"
30
+ }
31
+ },
32
+ "required": [
33
+ "query_text"
34
+ ]
35
+ }
36
+ }
@@ -0,0 +1,40 @@
1
+ {
2
+ "name": "patent_query_search",
3
+ "description": "检索式检索专利:根据 Analytics 风格检索式在全球专利库中检索并分页返回专利列表(pn、patent_id 等)。必填 query_text;可选 collapse_type/collapse_by/collapse_order 控制去重折叠,sort 指定排序,limit/offset 分页(limit+offset ≤ 20000)。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "collapse_by": {
8
+ "description": "去重内部排序字段(可选),与 collapse_type 配合使用:APD=申请日;PBD=公开日;AUTHORITY=受理局;SCORE=相关性。",
9
+ "type": "string"
10
+ },
11
+ "collapse_order": {
12
+ "description": "去重内部排序方向(可选),collapse_type=APNO 且 collapse_by=APD/PBD 时生效:OLDEST=取最早;LATEST=取最新。",
13
+ "type": "string"
14
+ },
15
+ "collapse_type": {
16
+ "description": "去重/折叠口径(可选):ALL=不去重;APNO=按申请号;DOCDB=按简单同族;INPADOC=按 INPADOC 同族;EXTEND=按平台扩展同族。缺省等价于 ALL。",
17
+ "type": "string"
18
+ },
19
+ "limit": {
20
+ "description": "单次返回条数(可选),默认 10,最大 1000;需满足 limit + offset ≤ 20000。",
21
+ "type": "integer"
22
+ },
23
+ "offset": {
24
+ "description": "分页偏移量(可选),默认 0;需满足 limit + offset ≤ 20000。",
25
+ "type": "integer"
26
+ },
27
+ "query_text": {
28
+ "description": "检索式(Analytics 风格语法),必填;最大 12000 字符。示例:TACD: virtual reality",
29
+ "type": "string"
30
+ },
31
+ "sort": {
32
+ "description": "排序规则(可选),JSON 数组字符串,每项含 field 和 order。field 可选:PBDT_YEARMONTHDAY / APD_YEARMONTHDAY / ISD / SCORE;order 为 DESC 或 ASC。示例:[{\"field\":\"PBDT_YEARMONTHDAY\",\"order\":\"DESC\"}]",
33
+ "type": "string"
34
+ }
35
+ },
36
+ "required": [
37
+ "query_text"
38
+ ]
39
+ }
40
+ }
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "patent_query_search_with_agg",
3
+ "description": "检索式检索专利并按指定维度聚合统计:根据 Analytics 检索式检索专利,同时按 field 指定的维度(如 ASSIGNEE、IPC 等)返回聚合分布数据(name + count)。必填 query、field、limit、offset;limit+offset ≤ 200;field 最多 5 个,逗号分隔。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "collapse_by": {
8
+ "description": "去重排序字段:APD / PBD / AUTHORITY / SCORE",
9
+ "type": "string"
10
+ },
11
+ "collapse_order": {
12
+ "description": "去重排序方向(collapse_by=APD/PBD 时):OLDEST / LATEST",
13
+ "type": "string"
14
+ },
15
+ "collapse_order_authority": {
16
+ "description": "受理局优先级(collapse_by=AUTHORITY 时),国家代码 JSON 数组字符串,如 [\"CN\",\"US\"]",
17
+ "type": "string"
18
+ },
19
+ "collapse_type": {
20
+ "description": "去重口径:ALL / APNO / DCCDB / INPADOC / EXTEND",
21
+ "type": "string"
22
+ },
23
+ "field": {
24
+ "description": "聚合维度,英文逗号分隔,最多 5 个;可选代码见接口文档表 1.4,示例:ASSIGNEE,IPC",
25
+ "type": "string"
26
+ },
27
+ "lang": {
28
+ "description": "语言:cn(默认)/ en / jp",
29
+ "type": "string"
30
+ },
31
+ "limit": {
32
+ "description": "每维度返回条数,范围 1~100,默认 50",
33
+ "type": "integer"
34
+ },
35
+ "offset": {
36
+ "description": "偏移量,须满足 0 ≤ offset + limit ≤ 200",
37
+ "type": "integer"
38
+ },
39
+ "query": {
40
+ "description": "Analytics 检索式,最大 3000 字符;不支持 SW/$PRE/$WS/$SEN/$PARA/$FREQ 等算子",
41
+ "type": "string"
42
+ },
43
+ "stemming": {
44
+ "description": "词干化:1=开启,0=关闭(默认)",
45
+ "type": "integer"
46
+ }
47
+ },
48
+ "required": [
49
+ "query",
50
+ "field",
51
+ "limit",
52
+ "offset"
53
+ ]
54
+ }
55
+ }
@@ -0,0 +1,48 @@
1
+ {
2
+ "name": "patent_semantic_search",
3
+ "description": "语义检索相似专利:输入一段技术描述文本(建议 ≥200 字),通过语义向量检索全球专利库中最相似的专利,返回 pn、patent_id 及相似度(relevancy)。可按国家、申请日/公开日范围、相似度阈值筛选;limit+offset ≤ 20000,单次最多返回 1000 条。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "apd_from": {
8
+ "description": "申请日开始,8 位数字 YYYYMMDD 或 * 表示不限",
9
+ "type": "string"
10
+ },
11
+ "apd_to": {
12
+ "description": "申请日结束,格式同 apd_from",
13
+ "type": "string"
14
+ },
15
+ "country": {
16
+ "description": "国家/地区及申请类型代码 JSON 数组字符串,如 [\"CNA\",\"CNB\",\"USB\"];A=发明申请/B=授权发明/U=实用新型/D=外观",
17
+ "type": "string"
18
+ },
19
+ "limit": {
20
+ "description": "返回条数,默认 10,最大 1000",
21
+ "type": "integer"
22
+ },
23
+ "offset": {
24
+ "description": "分页偏移,limit+offset ≤ 20000",
25
+ "type": "integer"
26
+ },
27
+ "pbd_from": {
28
+ "description": "公开日开始,8 位数字或 *",
29
+ "type": "string"
30
+ },
31
+ "pbd_to": {
32
+ "description": "公开日结束,格式同 pbd_from",
33
+ "type": "string"
34
+ },
35
+ "relevancy": {
36
+ "description": "相似度阈值,如 50%,仅返回高于该阈值的专利",
37
+ "type": "string"
38
+ },
39
+ "text": {
40
+ "description": "用于语义检索的技术描述文本,建议不少于 200 字,如权利要求或技术方案摘录",
41
+ "type": "string"
42
+ }
43
+ },
44
+ "required": [
45
+ "text"
46
+ ]
47
+ }
48
+ }
@@ -0,0 +1 @@
1
+ """TikTok MCP tool manifests."""
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "tk_expert_sale_show",
3
+ "description": "查询达人销售表现:销售渠道 GMV 占比、商品类目 GMV 占比(name + 占比 value,多为小数)。无行业/占比数据时业务可能返回 data 为 null。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "countryRegion": {
8
+ "description": "国家/地区(中文名);Java 默认「美国」,不传时按服务端默认值",
9
+ "type": "string"
10
+ },
11
+ "expertId": {
12
+ "description": "达人 ID;@NotBlank",
13
+ "type": "string"
14
+ }
15
+ },
16
+ "required": [
17
+ "expertId"
18
+ ]
19
+ }
20
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "name": "tt_commodity_detail",
3
+ "description": "TT 商品详情:图片、标题、链接、类目、价格、销量/销售额、达人数与视频数、星级、店铺信息、关注状态等。态;无查看全部权限时受详情次数额度限制。密钥仅走网关。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "commodityId": {
8
+ "description": "TT 商品 ID;为空时报「商品编号不能为空」。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区;为空时服务端校验失败(与站内选品一致)。",
13
+ "type": "string"
14
+ }
15
+ },
16
+ "required": [
17
+ "commodityId",
18
+ "countryRegion"
19
+ ]
20
+ }
21
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "tt_commodity_expert_draw_expert_trend",
3
+ "description": "TT 商品带货达人数量按月趋势:返回每月达人数量。态;无法解析商品时可能返回业务错误(如 100100103)。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "commodityId": {
8
+ "description": "TT 商品 ID;为空时报「商品编号不能为空」。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区,建议与选品一致;未在 paramCheck 强制,但影响数据口径。",
13
+ "type": "string"
14
+ }
15
+ },
16
+ "required": [
17
+ "commodityId"
18
+ ]
19
+ }
20
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "tt_commodity_get_commodity_cat_tree",
3
+ "description": "获取 TT B2C 全量类目树(根 parentId 为 -1,最深约 6 层)。无 JSON Body,可发 {}。类目展示名 catCnName 随请求头 Language(网关注入)。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {}
7
+ }
8
+ }
@@ -0,0 +1,180 @@
1
+ {
2
+ "name": "tt_commodity_info_list",
3
+ "description": "TT 选品商品分页列表:多条件筛选、排序、图搜;返回 Page(records 为商品行)。态;无查看全部时仅前 3 页;commodityName 非空消耗搜索额度。密钥仅走网关,勿写入模板。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "commodityCatId": {
8
+ "description": "类目 ID(筛选)。",
9
+ "type": "string"
10
+ },
11
+ "commodityCategory": {
12
+ "description": "商品类目(筛选)。",
13
+ "type": "string"
14
+ },
15
+ "commodityIdList": {
16
+ "description": "商品 ID 列表,批量筛选。",
17
+ "type": "array"
18
+ },
19
+ "commodityName": {
20
+ "description": "商品名称关键词;非空时消耗选品搜索次数额度(无查看全部权限时超限报错)。",
21
+ "type": "string"
22
+ },
23
+ "countryRegion": {
24
+ "description": "国家/地区,与站内选品一致;为空时服务端校验失败。",
25
+ "type": "string"
26
+ },
27
+ "current": {
28
+ "description": "当前页码,默认 1;无「查看全部」权限时 current>3 会报错。",
29
+ "type": "integer"
30
+ },
31
+ "dataPeriod": {
32
+ "description": "数据维度:日/周/月等业务口径。",
33
+ "type": "string"
34
+ },
35
+ "date": {
36
+ "description": "数据日期,JSON 建议 yyyy-MM-dd(GMT+8,与 @JsonFormat 一致)。",
37
+ "type": "string"
38
+ },
39
+ "expertId": {
40
+ "description": "达人编号,关联筛选。",
41
+ "type": "string"
42
+ },
43
+ "isCrossBorder": {
44
+ "description": "是否全托管等(Integer,与业务约定一致)。",
45
+ "type": "integer"
46
+ },
47
+ "isNew": {
48
+ "description": "是否新品(字符串筛选,与业务约定一致)。",
49
+ "type": "string"
50
+ },
51
+ "offset": {
52
+ "description": "偏移量(分页模型字段,按需)。",
53
+ "type": "integer"
54
+ },
55
+ "orderType": {
56
+ "description": "排序:reviewsNumberAsc/Desc、totalSalesNumberAsc/Desc(默认总销量降序)、totalSaleIncomeNumberAsc/Desc、powerSellerNumberAsc/Desc、shelfTimeAsc/Desc。",
57
+ "type": "string"
58
+ },
59
+ "pictureKeyWord": {
60
+ "description": "图搜关键词。",
61
+ "type": "string"
62
+ },
63
+ "pictureUrl": {
64
+ "description": "图搜图片公网 URL;与 pictureKeyWord 任一有值时走图搜。",
65
+ "type": "string"
66
+ },
67
+ "powerSellerNumberEnd": {
68
+ "description": "带货达人数区间终点。",
69
+ "type": "integer"
70
+ },
71
+ "powerSellerNumberStart": {
72
+ "description": "带货达人数区间起点;仅填一端时另一端自动补全。",
73
+ "type": "integer"
74
+ },
75
+ "priceEnd": {
76
+ "description": "最大价格(数值,JSON 数字)。",
77
+ "type": "string"
78
+ },
79
+ "priceStart": {
80
+ "description": "最小价格(数值,JSON 数字)。",
81
+ "type": "string"
82
+ },
83
+ "reportDateEnd": {
84
+ "description": "报告日期终点(字符串)。",
85
+ "type": "string"
86
+ },
87
+ "reportDateStart": {
88
+ "description": "报告日期起点(字符串)。",
89
+ "type": "string"
90
+ },
91
+ "reportMonthEnd": {
92
+ "description": "报告月份终点(字符串)。",
93
+ "type": "string"
94
+ },
95
+ "reportMonthStart": {
96
+ "description": "报告月份起点(字符串)。",
97
+ "type": "string"
98
+ },
99
+ "reviewsNumberEnd": {
100
+ "description": "评论数区间终点。",
101
+ "type": "integer"
102
+ },
103
+ "reviewsNumberStart": {
104
+ "description": "评论数区间起点;仅填一端时另一端自动补全。",
105
+ "type": "integer"
106
+ },
107
+ "saleTimeEnd": {
108
+ "description": "销售时间范围终点(字符串)。",
109
+ "type": "string"
110
+ },
111
+ "saleTimeStart": {
112
+ "description": "销售时间范围起点(字符串)。",
113
+ "type": "string"
114
+ },
115
+ "salesEnd": {
116
+ "description": "销量区间终点。",
117
+ "type": "integer"
118
+ },
119
+ "salesStart": {
120
+ "description": "销量区间起点。",
121
+ "type": "integer"
122
+ },
123
+ "salesVolumeEnd": {
124
+ "description": "销售额区间终点(数值,JSON 数字)。",
125
+ "type": "string"
126
+ },
127
+ "salesVolumeStart": {
128
+ "description": "销售额区间起点(数值,JSON 数字)。",
129
+ "type": "string"
130
+ },
131
+ "scoreEnd": {
132
+ "description": "最大评分(数值,JSON 数字)。",
133
+ "type": "string"
134
+ },
135
+ "scoreStart": {
136
+ "description": "最小评分(数值,JSON 数字)。",
137
+ "type": "string"
138
+ },
139
+ "shelfTimeEnd": {
140
+ "description": "上架时间范围终点。",
141
+ "type": "string"
142
+ },
143
+ "shelfTimeStart": {
144
+ "description": "上架时间范围起点(与后端 Date 反序列化格式一致,如时间戳或 ISO)。",
145
+ "type": "string"
146
+ },
147
+ "shopId": {
148
+ "description": "店铺编号,关联筛选。",
149
+ "type": "string"
150
+ },
151
+ "size": {
152
+ "description": "每页条数,默认 10,最大 30(超出抛业务异常)。",
153
+ "type": "integer"
154
+ },
155
+ "totalSaleIncomeNumberEnd": {
156
+ "description": "总销售额区间终点(数值,JSON 数字)。",
157
+ "type": "string"
158
+ },
159
+ "totalSaleIncomeNumberStart": {
160
+ "description": "总销售额区间起点(数值,JSON 数字);仅填一端时另一端自动补全。",
161
+ "type": "string"
162
+ },
163
+ "totalSalesNumberEnd": {
164
+ "description": "总销量区间终点。",
165
+ "type": "integer"
166
+ },
167
+ "totalSalesNumberStart": {
168
+ "description": "总销量区间起点;仅填一端时另一端自动补全。",
169
+ "type": "integer"
170
+ },
171
+ "videoId": {
172
+ "description": "视频编号,关联筛选。",
173
+ "type": "string"
174
+ }
175
+ },
176
+ "required": [
177
+ "countryRegion"
178
+ ]
179
+ }
180
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "name": "tt_commodity_sales_trend",
3
+ "description": "TT 商品销售趋势:返回多条序列(销量、销售额、价格等 analyzeTrendType),每条含 commodityAnalyzeTrendList 坐标点(JSON 字段 name/value)。时间窗口由 pastMonth / pastDays / month 三选一优先级决定。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "commodityId": {
8
+ "description": "TT 商品 ID;与 shopId 至少填其一,否则报「编号不能为空」。本接口为商品维度趋势,建议传此字段。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区,建议与选品站点一致,否则可能无数据或不准。",
13
+ "type": "string"
14
+ },
15
+ "month": {
16
+ "description": "自然月 yyyyMM(如 202503);pastMonth、pastDays 均未传时使用,该月内按日展开。",
17
+ "type": "string"
18
+ },
19
+ "pastDays": {
20
+ "description": "按日:pastMonth 未传时可用,最近 pastDays 天(日粒度,口径以服务端为准)。",
21
+ "type": "integer"
22
+ },
23
+ "pastMonth": {
24
+ "description": "按月回溯:非空时优先使用,从当前月起共 pastMonth 个月(月粒度)。",
25
+ "type": "integer"
26
+ },
27
+ "shopId": {
28
+ "description": "店铺编号;与 commodityId 至少填其一。商品趋势场景可仅传 commodityId。",
29
+ "type": "string"
30
+ }
31
+ }
32
+ }
33
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "tt_commodity_statistics_get_category_statistics",
3
+ "description": "TT 品类热力图统计:按国家/地区与周期返回一级类目及 children 二级类目树,含销量/销售额/集中度及环比等(字符串指标)。类目展示名随请求头 Language。相同条件结果可缓存约 24h。态;密钥仅走网关。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "categoryEnName": {
8
+ "description": "可选;非空时仅保留一级类目 levelCatName 与该英文名相等的一级节点。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区,与站内选品一致;为空时 paramCheck 失败。",
13
+ "type": "string"
14
+ },
15
+ "dataPeriod": {
16
+ "description": "统计周期:last7d(默认)或 last30d;影响指标与周/月环比字段含义。",
17
+ "type": "string"
18
+ },
19
+ "orderType": {
20
+ "description": "排序:totalSalesNumberAsc/Desc(默认 totalSalesNumberDesc)、totalSaleIncomeNumberAsc/Desc;与 dataPeriod 组合决定比较字段,其它取值以服务端为准。",
21
+ "type": "string"
22
+ }
23
+ },
24
+ "required": [
25
+ "countryRegion"
26
+ ]
27
+ }
28
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "tt_commodity_statistics_get_expert_statistics",
3
+ "description": "TT 带货达人矩阵:按粉丝数档位统计 TT 号数、销量、带货视频数、达人平均销售额产出及各项占比。相同 dataPeriod+countryRegion 缓存约 24h。态;密钥仅走网关。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "categoryEnName": {
8
+ "description": "与其它统计接口共用 Request;达人矩阵 SQL 未使用,可忽略。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区,与站内选品一致;为空时 paramCheck 失败。",
13
+ "type": "string"
14
+ },
15
+ "dataPeriod": {
16
+ "description": "统计周期,默认 last7d;参与缓存 key;当前 SQL 是否按该字段区分以服务端为准。",
17
+ "type": "string"
18
+ },
19
+ "orderType": {
20
+ "description": "与其它统计接口共用 Request;本接口 SQL 不使用;返回行顺序由数据侧 sort_order 决定。",
21
+ "type": "string"
22
+ }
23
+ },
24
+ "required": [
25
+ "countryRegion"
26
+ ]
27
+ }
28
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "tt_commodity_statistics_get_price_statistics",
3
+ "description": "TT 价格分布统计:按本地货币价格带统计各带内销量、销售额与商品数;列表中 periodType 为 7天/30天。startRange/endRange 随国家汇率换算。可选 categoryEnName 过滤。相同条件缓存约 24h。态;密钥仅走网关。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "categoryEnName": {
8
+ "description": "可选;非空时仅统计该 category_name 下商品。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区,与站内选品一致;为空时 paramCheck 失败。",
13
+ "type": "string"
14
+ },
15
+ "dataPeriod": {
16
+ "description": "统计周期,默认 last7d;参与缓存 key;底层一次返回 7天/30天 两套价格带,按 periodType 筛选展示。",
17
+ "type": "string"
18
+ },
19
+ "orderType": {
20
+ "description": "与其它统计接口共用 Request;本接口价格分桶 SQL 不使用该字段,可忽略。",
21
+ "type": "string"
22
+ }
23
+ },
24
+ "required": [
25
+ "countryRegion"
26
+ ]
27
+ }
28
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "tt_commodity_statistics_get_total_statistics",
3
+ "description": "TT 商品大盘总览:按国家/地区与周期返回总销量、总销售额、动销商品数、均价、动销新品与新品销售额及各项环比(字符串指标);可选 categoryEnName 过滤。相同条件结果 Redis 缓存约 24h。态;密钥仅走网关。",
4
+ "arguments": {
5
+ "type": "object",
6
+ "properties": {
7
+ "categoryEnName": {
8
+ "description": "可选;按一级类目英文名过滤(与数据侧 category_name 匹配)。",
9
+ "type": "string"
10
+ },
11
+ "countryRegion": {
12
+ "description": "国家/地区,与站内选品一致;为空时 paramCheck 失败。",
13
+ "type": "string"
14
+ },
15
+ "dataPeriod": {
16
+ "description": "统计周期:last7d(默认,近7日)或 last30d(近30日);决定返回指标对应窗口与环比口径。",
17
+ "type": "string"
18
+ },
19
+ "orderType": {
20
+ "description": "与其它统计接口共用 CommodityStatisticsRequest;本接口总览聚合不使用该字段排序,可忽略。",
21
+ "type": "string"
22
+ }
23
+ },
24
+ "required": [
25
+ "countryRegion"
26
+ ]
27
+ }
28
+ }