sino-bc-cli 1.7.0 → 1.8.1

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.
package/README.md CHANGED
@@ -140,10 +140,9 @@ sino-bc-cli/
140
140
  │ │
141
141
  │ ├── commands/ # 📦 命令实现层(每命令一个文件,可独立扩展)
142
142
  │ │ ├── index.ts # 命令批量注册入口
143
- │ │ ├── init.command.ts # /init 命令实现(注册 Agent 技能 + 初始化变量配置 + 自动 /mcp-reload)
143
+ │ │ ├── init.command.ts # /init 命令实现(注册 Agent 技能 + 初始化变量配置 + 拉取启动 MCP)
144
144
  │ │ ├── api-list.command.ts # /api-list 命令实现(列出接口并打开文档)
145
- │ │ ├── api-endpoint.command.ts # 接口调用类命令基类(按接口 transport 分发 gateway / mcp)
146
- │ │ ├── ic-api.command.ts # /ic-api 命令实现(调用 iCenter 接口地址)
145
+ │ │ ├── api-endpoint.command.ts # 接口调用类命令基类(经网关 HTTP 调用)
147
146
  │ │ ├── bc-api.command.ts # /bc-api 命令实现(调用业务线查询 / 业务线策略接口)
148
147
  │ │ ├── get-config.command.ts # /get-config 命令实现(查看变量配置与 MCP 配置)
149
148
  │ │ ├── set-config.command.ts # /set-config 命令实现(修改变量配置)
@@ -160,8 +159,8 @@ sino-bc-cli/
160
159
  │ │ ├── prompt.ts # 终端交互(复用单一 readline 会话:提问、选择、确认)
161
160
  │ │ ├── config-store.ts # 变量配置读写(字段元信息 + 读 / 写 / 删)
162
161
  │ │ ├── config-prompt.ts # 变量配置交互采集(/init 与 /set-config 共用)
163
- │ │ ├── mcp-store.ts # ~/.sino-bc-cli/mcp.json 读写(与 Cursor 同结构)
164
- │ │ ├── mcp-service.ts # MCP 服务启动 / 关闭 / tools/call
162
+ │ │ ├── mcp-store.ts # ~/.sino-bc-cli/mcp.json 读写
163
+ │ │ ├── mcp-service.ts # MCP 同步到 Cursor / Codex / Claude / VS Code 并握手
165
164
  │ │ └── skill-install.ts # Agent 技能目录的写入与清理
166
165
  │ │
167
166
  │ ├── types/ # 📝 类型定义层
@@ -247,8 +246,8 @@ npm run dev -- [参数]
247
246
  # 示例:查看帮助
248
247
  npm run dev -- --help
249
248
 
250
- # 示例:执行 /ic-api 命令
251
- npm run dev -- /ic-api
249
+ # 示例:执行 /bc-api 命令
250
+ npm run dev -- /bc-api
252
251
  ```
253
252
 
254
253
  ### 5. 全局安装(推荐)
@@ -271,7 +270,7 @@ npm i sino-bc-cli -g
271
270
  sino-bc-cli --help
272
271
  sino-bc-cli /init
273
272
  sino-bc-cli /api-list
274
- sino-bc-cli /ic-api
273
+ sino-bc-cli /bc-api
275
274
  ```
276
275
 
277
276
  `npm i sino-bc-cli -g` 完成后会自动执行 `/init`,把 `SKILL.md` 写到用户主目录的 Agent 技能目录(`~/.agents/skills/sino-bc-cli` 等)。飞书豆包工作:技能·连接器 → 管理 → **本地** → 刷新。若未出现,手动执行:
@@ -290,25 +289,24 @@ sino-bc-cli /init
290
289
 
291
290
  | 命令 | 说明 |
292
291
  | :---------- | :-------------------------------------------------------------------------------------------- |
293
- | `/init` | 注册 `SKILL.md` 到 Agent 技能目录,交互设置环境 / `API_KEY`,并自动执行 `/mcp-reload` |
292
+ | `/init` | 注册 `SKILL.md` 到 Agent 技能目录,交互设置环境 / `API_KEY`,并拉取启动 MCP |
294
293
  | `/api-list` | 列出全部可调用接口;Cursor / VS Code 终端中 Ctrl+单击接口名或文档路径打开本地文档,也可输入序号或传入 name |
295
- | `/ic-api` | 交互选择并调用 iCenter 接口;**不接收参数**。固定走 MCP(`tools/list` 补齐远端新增 + `tools/call`),不通不回退网关 |
296
- | `/bc-api` | 交互选择并调用业务线查询 / 业务线策略接口(共 22 个,路径统一带 `/sino-opti-hive` 前缀);**不接收参数**。固定走网关 HTTP |
294
+ | `/bc-api` | 交互选择并调用业务线查询 / 业务线策略接口(共 22 个,路径统一带 `/sino-opti-hive` 前缀);**不接收参数**。经网关 HTTP |
297
295
  | `/get-config` | 查看变量配置与 `mcp.json`;密钥默认打码,`--show-secret` 显示明文,`--json` 输出 JSON |
298
296
  | `/set-config` | 修改变量配置(环境 / API_KEY);不带参数时逐项交互修改 |
299
- | `/mcp-reload` | 重新读取 `~/.sino-bc-cli/mcp.json`,同步到 Cursor / Claude 并重新握手 |
300
- | `/uninstall` | 关闭 MCP 服务,删除 `/init` 创建的技能目录与变量配置文件,并从全局 npm 卸载本 CLI |
297
+ | `/mcp-reload` | 重新读取 `~/.sino-bc-cli/mcp.json`,同步到 Cursor / Codex / Claude / VS Code 并重新握手 |
298
+ | `/uninstall` | 关闭本 CLI 写入的 MCP,删除技能目录与变量配置文件,并从全局 npm 卸载本 CLI |
301
299
 
302
300
  ### 变量配置文件
303
301
 
304
302
  环境、`API_KEY` 存放在 `<用户主目录>/.sino-bc-cli/config.json`。`X-GATEWAY-TYPE` 固定为 `A2C-CLI`,不开放配置。
305
303
 
306
- MCP 地址与 Token 存放在 `<用户主目录>/.sino-bc-cli/mcp.json`,结构与 Cursor 的 `mcp.json` 一致,可直接编辑后执行 `/mcp-reload`。
304
+ MCP Server 存放在 `<用户主目录>/.sino-bc-cli/mcp.json`,结构与 Cursor 的 `mcp.json` 一致。用户自行增删后执行 `/mcp-reload`,CLI 会同步到 Cursor、Codex、Claude Code、VS Code。
307
305
 
308
306
  | 字段 | 命令行键名 | 默认值 | 说明 |
309
307
  | :--- | :--------- | :----- | :--- |
310
308
  | `env` | `env` | `prod` | 目标环境,可选 `test` / `pre` / `prod` |
311
- | `apiKey` | `api-key` | 内置默认 Key | 网关鉴权用的 API Key(`/bc-api` 与业务线接口使用) |
309
+ | `apiKey` | `api-key` | 内置默认 Key | 网关鉴权用的 API Key(`/bc-api` 使用) |
312
310
 
313
311
  ```bash
314
312
  # 查看(密钥打码)
@@ -322,12 +320,26 @@ sino-bc-cli /set-config --env=test
322
320
  # 不带参数则逐项交互修改,直接回车保留当前值
323
321
  sino-bc-cli /set-config
324
322
 
325
- # 改 MCP 地址或 Token:编辑文件后重启
323
+ # 改 MCP:编辑文件后重启
326
324
  # %USERPROFILE%\.sino-bc-cli\mcp.json
327
325
  sino-bc-cli /mcp-reload
328
326
  ```
329
327
 
330
- > `/init` 结束时自动执行 `/mcp-reload`(`mcp.json` 不存在则按默认值创建,已存在不覆盖)。非交互环境(npm `postinstall`、CI、Agent 调用)下不提问。MCP 失败只警告,`/ic-api` 调用时再报错。
328
+ ```json
329
+ {
330
+ "mcpServers": {
331
+ "example": {
332
+ "type": "streamable-http",
333
+ "url": "https://your-mcp-gateway/mcp/",
334
+ "headers": {
335
+ "Authorization": "Bearer <token>"
336
+ }
337
+ }
338
+ }
339
+ }
340
+ ```
341
+
342
+ > `/init` 结束时自动拉取并启动 `mcp.json`(文件不存在则创建空清单,已存在不覆盖)。非交互环境(npm `postinstall`、CI、Agent 调用)下不提问。MCP 失败只警告。
331
343
 
332
344
  ### 全局选项
333
345
 
@@ -339,7 +351,7 @@ sino-bc-cli /mcp-reload
339
351
 
340
352
  ### 环境与请求网关
341
353
 
342
- `/bc-api` 与业务线文档接口的请求地址由 [`src/constants/gateway.ts`](./src/constants/gateway.ts) 的 `GATEWAY_CONFIG` 决定,命令内部统一走 `joinGatewayUrl(env, path)` 拼接。`/ic-api` 及其他接口固定走 MCP `tools/call`,不走网关。
354
+ `/bc-api` 的请求地址由 [`src/constants/gateway.ts`](./src/constants/gateway.ts) 的 `GATEWAY_CONFIG` 决定,命令内部统一走 `joinGatewayUrl(env, path)` 拼接。业务线路径带 `/sino-opti-hive`。iCenter 请写入 `mcp.json` 后 `/mcp-reload`。
343
355
 
344
356
  | `ENV` | 说明 | 网关地址 |
345
357
  | :----- | :------- | :----------------------------------- |
@@ -371,16 +383,16 @@ sino-bc-cli /api-list 3
371
383
  sino-bc-cli /api-list biz-line-open-list
372
384
  ```
373
385
 
374
- 执行效果:按「iCenter MCP / 业务线查询 / 业务线策略」分组列出全部接口。接口名是终端超链接,文档路径可 Ctrl+单击打开对应 markdown;交互终端也可输入序号。传入序号或接口 `name` 则直接打开该文档。
386
+ 执行效果:按「业务线查询 / 业务线策略」分组列出全部接口。接口名是终端超链接,文档路径可 Ctrl+单击打开对应 markdown;交互终端也可输入序号。传入序号或接口 `name` 则直接打开该文档。
375
387
 
376
- #### ③ 经 MCP 调用 iCenter 接口
388
+ #### ③ 配置并重启 MCP
377
389
 
378
390
  ```bash
379
- sino-bc-cli /ic-api
391
+ # 编辑 %USERPROFILE%\.sino-bc-cli\mcp.json 后
392
+ sino-bc-cli /mcp-reload
380
393
  ```
381
394
 
382
- 执行效果:交互选择接口后,经 MCP `tools/call` 发起请求(`tools/list` 会补齐远端新增)。不通不回退网关。
383
- 本命令不接收参数,切换环境请先执行 `sino-bc-cli /set-config env <test|pre|prod>`。
395
+ 执行效果:把 `mcp.json` 里的 Server 同步到 Cursor(`~/.cursor/mcp.json`)、Codex(`~/.codex/config.toml`)、Claude Code(`~/.claude.json`)、VS Code 用户级 `mcp.json`,并对带 `url` 的 Server 做 initialize 握手。
384
396
 
385
397
  #### ④ 调用业务线查询 / 业务线策略接口
386
398
 
@@ -395,9 +407,9 @@ sino-bc-cli /bc-api
395
407
  #### ⑤ 启用 Debug 模式运行
396
408
 
397
409
  ```bash
398
- sino-bc-cli --debug /ic-api
410
+ sino-bc-cli --debug /bc-api
399
411
  # 或使用短选项
400
- sino-bc-cli -d /ic-api
412
+ sino-bc-cli -d /bc-api
401
413
  ```
402
414
 
403
415
  Debug 模式会输出详细的日志,包括参数解析、命令注册、接口调用过程等信息,便于排查问题。
package/dist/SKILL.md CHANGED
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: sino-bc-cli
3
3
  description: >
4
- Use when 查询或操作 BeyondClick / iCenter / 业务线数据:Facebook / Google / TikTok 广告策略维度或成效、
5
- 投放渠道、投放品类、业务线列表/详情/策略与表现、Top 业务线、周策略增删改查、
4
+ Use when 查询或操作 BeyondClick 业务线数据:投放渠道、投放品类、
5
+ 业务线列表/详情/策略与表现、Top 业务线、周策略增删改查、
6
6
  红绿灯、客户满意度、消耗、ROAS;或用户提到 sino-bc-cli、/init、/api-list、
7
- /ic-api、/bc-api、/get-config、/set-config、/uninstall、sino-icenter、
7
+ /bc-api、/get-config、/set-config、/mcp-reload、/uninstall、
8
8
  sino-opti-hive、A2C-CLI。
9
9
  metadata:
10
10
  requires:
@@ -13,14 +13,15 @@ metadata:
13
13
 
14
14
  # sino-bc-cli
15
15
 
16
- BeyondClick 投放数据与业务线策略的 Agent 调用入口。用本 CLI 发现接口和文档,再按用户真实参数请求网关。
16
+ BeyondClick 业务线策略的 Agent 调用入口。用本 CLI 发现接口和文档,再按用户真实参数请求网关。
17
+ iCenter 不走本 CLI 接口清单:用户把 MCP Server 写进 `~/.sino-bc-cli/mcp.json`,`/init` 或 `/mcp-reload` 会同步到 Cursor / Codex / Claude / VS Code。
17
18
 
18
19
  ## When to Use
19
20
 
20
- - 查 Facebook / Google / TikTok 广告策略配置、消耗/点击/购买等成效
21
21
  - 查投放渠道、投放行业/品类、业务线主数据、周策略与表现、行业 Top
22
22
  - 新建/编辑/删除业务线或周策略(须先确认环境和写操作意图)
23
- - 用户点名 `/api-list`、`/ic-api`、`/bc-api`、iCenter、sino-opti-hive
23
+ - 用户点名 `/api-list`、`/bc-api`、`/mcp-reload`、sino-opti-hive
24
+ - 用户要给 Cursor / Codex / Claude / VS Code 增加或重启 MCP
24
25
 
25
26
  不要用本技能处理:本仓库源码开发、扩展命令、npm 发版(见 `README.md` / `ReleaseSteps.md`)。
26
27
 
@@ -29,21 +30,21 @@ BeyondClick 投放数据与业务线策略的 Agent 调用入口。用本 CLI
29
30
  | 项 | 规则 |
30
31
  | --- | --- |
31
32
  | 环境 | `test` / `pre` / `prod`,取自变量配置文件,默认 `prod` |
32
- | 网关 | `https://test-agent.beyondclick.com`(当前三环境同一地址;仅业务线文档与 `/bc-api` 走网关,不直连服务地址) |
33
- | iCenter | 固定走 MCP `tools/call`,不通不回退网关 |
33
+ | 网关 | `https://test-agent.beyondclick.com`(当前三环境同一地址;`/bc-api` 走网关,不直连服务地址) |
34
34
  | 业务线前缀 | `/sino-opti-hive` |
35
35
  | 鉴权 | `Authorization: Bearer <API_KEY>`;取自变量配置文件,未设置时用 CLI 内置默认值 |
36
36
  | 来源头 | 必须带 `X-GATEWAY-TYPE: A2C-CLI`(CLI 固定写入,不开放配置) |
37
- | 请求体 | 按用户条件组装;禁止原样提交文档示例账号/业务线 ID |
37
+ | 请求体 | 按用户条件组装;禁止原样提交文档示例业务线 ID |
38
+ | iCenter / 其他 MCP | 编辑 `~/.sino-bc-cli/mcp.json` 后执行 `sino-bc-cli /mcp-reload` |
38
39
 
39
40
  ### 变量配置文件
40
41
 
41
42
  环境、`API_KEY` 存放在 `<用户主目录>/.sino-bc-cli/config.json`,由 `/init` 创建、`/set-config` 修改。
42
- MCP 地址与 Token 存放在 `<用户主目录>/.sino-bc-cli/mcp.json`(与 Cursor 同结构),可手改后执行 `sino-bc-cli /mcp-reload`。
43
+ MCP Server 存放在 `<用户主目录>/.sino-bc-cli/mcp.json`(与 Cursor 同结构),用户自行增删后执行 `/mcp-reload`。
43
44
  需要知道当前生效取值时执行 `sino-bc-cli /get-config --json`(密钥默认打码,加 `--show-secret` 才是明文)。
44
45
 
45
- `/ic-api`、`/bc-api` 不接收任何参数,且必须在交互式终端里选接口、只用文档默认 body。
46
- Agent 在非 TTY 下跑这两条会直接报错退出;需要真实查询时用 `/api-list` 发现接口后直接 HTTP。
46
+ `/bc-api` 不接收任何参数,且必须在交互式终端里选接口、只用文档默认 body。
47
+ Agent 在非 TTY 下跑这条会直接报错退出;需要真实查询时用 `/api-list` 发现接口后直接 HTTP。
47
48
 
48
49
  ## Agent 流程
49
50
 
@@ -52,6 +53,7 @@ Agent 在非 TTY 下跑这两条会直接报错退出;需要真实查询时用
52
53
  3. 写操作(描述含 ⚠️)先向用户确认环境和意图,未确认不发。
53
54
  4. 按约定发 GET/POST,解析 `success` / `code` / `message` / `result`。
54
55
  5. 回复用业务语言摘要;文档路径写成 Markdown 链接。完整 Key 不要回显。
56
+ 6. 用户要查 iCenter 广告策略时,使用已配置的 MCP 工具,不要走 `/bc-api`。
55
57
 
56
58
  ```bash
57
59
  curl -sS -X POST "https://test-agent.beyondclick.com/sino-opti-hive/biz-line-open/list" \
@@ -65,18 +67,6 @@ CLI 未安装:`npm i sino-bc-cli@latest -g`(需 Node.js >= 24)。技能未
65
67
 
66
68
  ## 意图 → 接口
67
69
 
68
- ### iCenter MCP(`/ic-api`,文档各一份 `<name>.md`)
69
-
70
- | 用户在问 | name | 注意 |
71
- | --- | --- | --- |
72
- | Facebook 广告策略配置(目标/出价/受众/创意,不含消耗) | `icenter-mcp-strategy-dimension-facebook-ad-list` | `dimensionValues` 只能有 `account_id`;账户须 `act_` 前缀;`dimensions` 非空;`country_code` 必须单独传 |
73
- | Facebook 策略 + 成效(消耗、点击、购买等) | `icenter-mcp-strategy-metrics-facebook-ad-list` | 最多近 21 天;`indicators` 非空 |
74
- | Google 广告策略配置(成效目标/出价/系列类型,不含消耗) | `icenter-mcp-strategy-dimension-google-ad-list` | 不支持广告目标和兴趣词包;出价用 `cpc_bid_amount` / `cpm_bid_amount` / `cpv_bid_amount`;`country_code` 必须单独传 |
75
- | Google 策略 + 成效 | `icenter-mcp-strategy-metrics-google-ad-list` | 最多近 21 天;`indicators` 非空 |
76
- | TikTok 广告策略配置(含转化出价/深度转化出价,不含消耗) | `icenter-mcp-strategy-dimension-tiktok-ad-list` | TikTok 独有 `conversion_bid` / `deep_cpabid`;`country_code` 必须单独传 |
77
- | TikTok 策略 + 成效 | `icenter-mcp-strategy-metrics-tiktok-ad-list` | 最多近 21 天;`indicators` 非空 |
78
- | iCenter git 版本 | `icenter-mcp-version-query` | GET,无 body |
79
-
80
70
  ### 业务线查询(只读,文档 `biz-line-query.md`)
81
71
 
82
72
  | 用户在问 | name | 注意 |
@@ -109,10 +99,9 @@ CLI 未安装:`npm i sino-bc-cli@latest -g`(需 Node.js >= 24)。技能未
109
99
  ```bash
110
100
  sino-bc-cli /api-list
111
101
  sino-bc-cli /api-list biz-line-open-list
112
- sino-bc-cli /ic-api # 交互选接口;不接收参数,用文档示例 body
113
102
  sino-bc-cli /bc-api
114
103
 
115
- sino-bc-cli /init # 注册技能 + 设置环境 / API_KEY,并自动 /mcp-reload
104
+ sino-bc-cli /init # 注册技能 + 设置环境 / API_KEY,并拉取启动 MCP
116
105
  sino-bc-cli /get-config # 查看变量配置与 mcp.json(密钥打码)
117
106
  sino-bc-cli /set-config env prod # 改单项;也支持 --env=prod、不带参数逐项交互
118
107
  sino-bc-cli /mcp-reload # 按 ~/.sino-bc-cli/mcp.json 重启 MCP
@@ -123,12 +112,11 @@ sino-bc-cli /uninstall # 清理技能目录与配置文件并
123
112
 
124
113
  | 错误 | 正确做法 |
125
114
  | --- | --- |
126
- | 非 TTY 执行 `/ic-api`、`/bc-api` | 这两条会报错退出;改直接 HTTP,只用 `/api-list` 发现接口 |
127
- | 给 `/ic-api`、`/bc-api` 传环境或 Key | 参数已下线;用 `/set-config` 改、`/get-config` 查 |
128
- | 用文档里的 `act_…` / `bizLineId: 1251` | 换成用户给出的账户或业务线 |
129
- | 成效接口一次查超过 21 天 | 拆段或改查维度接口 |
130
- | 把 `country_code` 和其他维度一起传 | 国家维度必须单独查,不能和其他维度同时传入 |
131
- | 漏 `X-GATEWAY-TYPE` 或业务线路径前缀 | 业务线带 `A2C-CLI` 与 `/sino-opti-hive`;iCenter 走 MCP 不要拼网关前缀 |
132
- | 直连 `o-test-tc-sino-icenter` / `o-test-sino-opti-hive` 等服务地址 | iCenter 走 MCP;业务线请求网关 `https://test-agent.beyondclick.com` + `/sino-opti-hive` |
115
+ | 非 TTY 执行 `/bc-api` | 这条会报错退出;改直接 HTTP,只用 `/api-list` 发现接口 |
116
+ | 给 `/bc-api` 传环境或 Key | 参数已下线;用 `/set-config` 改、`/get-config` 查 |
117
+ | 用文档里的 `bizLineId: 1251` | 换成用户给出的业务线 |
118
+ | 漏 `X-GATEWAY-TYPE` 或业务线路径前缀 | 带 `A2C-CLI` 与 `/sino-opti-hive` |
119
+ | 直连 `o-test-sino-opti-hive` 等服务地址 | 请求网关 `https://test-agent.beyondclick.com` + `/sino-opti-hive` |
120
+ | 改了 mcp.json 却不重启 | 执行 `sino-bc-cli /mcp-reload` |
133
121
  | 未确认就调 save/update/del | 先确认环境与写操作 |
134
122
  | 把 `exprot-all` 改成 `export-all` | 按服务端拼写调用 |
@@ -1,10 +1,11 @@
1
1
  # 接口文档索引
2
2
 
3
- 本目录汇总 CLI 可交互调用的接口。浏览清单用 `/api-list`(可点击打开本文档),发起调用用 `/ic-api` 与 `/bc-api`。
3
+ 本目录汇总 CLI 可交互调用的业务线接口。浏览清单用 `/api-list`(可点击打开本文档),发起调用用 `/bc-api`。
4
+
5
+ iCenter 不再随 CLI 提供接口文档。需要 iCenter 时,把 MCP Server 写进 `~/.sino-bc-cli/mcp.json`,再执行 `/init` 或 `/mcp-reload`,CLI 会同步到 Cursor / Codex / Claude / VS Code。
4
6
 
5
7
  | 分组 | 命令 | 接口数 | 文档 |
6
8
  | --- | --- | --- | --- |
7
- | iCenter MCP | `/ic-api` | 7 | 见下方「iCenter MCP 接口」 |
8
9
  | 业务线查询 | `/bc-api` | 5 | [biz-line-query.md](./biz-line-query.md) |
9
10
  | 业务线策略 | `/bc-api` | 17 | [biz-line-strategy.md](./biz-line-strategy.md) |
10
11
 
@@ -14,10 +15,10 @@
14
15
 
15
16
  | 范围 | 通道 |
16
17
  | --- | --- |
17
- | `biz-line-query.md` / `biz-line-strategy.md` 与 `/bc-api` | 固定走网关 HTTP |
18
- | `/ic-api` 及其他接口 | 固定走 MCP `tools/call`,不通不回退网关 |
18
+ | `biz-line-query.md` / `biz-line-strategy.md` 与 `/bc-api` | 固定走网关 HTTP,路径带 `/sino-opti-hive` |
19
+ | iCenter 及其他 MCP | 用户编辑 `~/.sino-bc-cli/mcp.json`,由 `/init`、`/mcp-reload` 同步并启动 |
19
20
 
20
- 网关地址的唯一来源是 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`;各文档中出现的上游服务地址(`o-test-tc-sino-icenter`、`o-test-sino-opti-hive` 等)仅作接口文档出处,不作为请求地址。
21
+ 网关地址的唯一来源是 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`;各文档中出现的上游服务地址(`o-test-sino-opti-hive` 等)仅作接口文档出处,不作为请求地址。
21
22
 
22
23
  | 环境 | 网关地址 |
23
24
  | --- | --- |
@@ -29,26 +30,6 @@
29
30
 
30
31
  ---
31
32
 
32
- ## iCenter MCP 接口
33
-
34
- 数据来源:[ContextForge MCP Gateway Admin - Tools](https://o-test-sino-mcp-gateway.meetsocial.cn/admin/?team_id=61761abbe4a4476c84c7df2cd7335a52#tools)
35
-
36
- 筛选规则:`name` 以 `icenter-mcp-` 开头。本地基线共 **7** 个接口,每个接口一份独立文档。`/ic-api` 固定走 MCP:`tools/list` 补齐远端新增(标「远端新增」),再 `tools/call`,不通不回退网关。
37
-
38
- | 文档 | name | 展示名 | 方法 | 说明 |
39
- | --- | --- | --- | --- | --- |
40
- | [icenter-mcp-strategy-dimension-facebook-ad-list.md](./icenter-mcp-strategy-dimension-facebook-ad-list.md) | `icenter-mcp-strategy-dimension-facebook-ad-list` | Facebook广告策略维度数据 | POST | 查询 Facebook 广告策略配置(不含成效指标) |
41
- | [icenter-mcp-strategy-metrics-facebook-ad-list.md](./icenter-mcp-strategy-metrics-facebook-ad-list.md) | `icenter-mcp-strategy-metrics-facebook-ad-list` | Facebook广告策略成效数据 | POST | 查询 Facebook 策略维度 + 成效指标(最多近 21 天) |
42
- | [icenter-mcp-strategy-dimension-google-ad-list.md](./icenter-mcp-strategy-dimension-google-ad-list.md) | `icenter-mcp-strategy-dimension-google-ad-list` | Google广告策略维度数据 | POST | 查询 Google 广告策略配置(不含成效指标) |
43
- | [icenter-mcp-strategy-metrics-google-ad-list.md](./icenter-mcp-strategy-metrics-google-ad-list.md) | `icenter-mcp-strategy-metrics-google-ad-list` | Google广告策略成效数据 | POST | 查询 Google 策略维度 + 成效指标(最多近 21 天) |
44
- | [icenter-mcp-strategy-dimension-tiktok-ad-list.md](./icenter-mcp-strategy-dimension-tiktok-ad-list.md) | `icenter-mcp-strategy-dimension-tiktok-ad-list` | TikTok广告策略维度数据 | POST | 查询 TikTok 广告策略配置(不含成效指标) |
45
- | [icenter-mcp-strategy-metrics-tiktok-ad-list.md](./icenter-mcp-strategy-metrics-tiktok-ad-list.md) | `icenter-mcp-strategy-metrics-tiktok-ad-list` | TikTok广告策略成效数据 | POST | 查询 TikTok 策略维度 + 成效指标(最多近 21 天) |
46
- | [icenter-mcp-version-query.md](./icenter-mcp-version-query.md) | `icenter-mcp-version-query` | 查询git最新提交版本 | GET | 查询 iCenter 服务 git 最新提交版本 |
47
-
48
- 对应命令:`/ic-api`,接口清单定义在 `src/constants/api-doc.ts`。
49
-
50
- ---
51
-
52
33
  ## 业务线接口(sino-opti-hive)
53
34
 
54
35
  数据来源:[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html)
@@ -76,28 +57,17 @@ sino-bc-cli /api-list 1
76
57
  sino-bc-cli /api-list biz-line-open-channels
77
58
  ```
78
59
 
79
- `/ic-api` 与 `/bc-api` 都是交互选接口后发起调用,请求体默认使用各文档「请求示例」;`GET` 接口无请求体。`/ic-api` 走 MCP,`/bc-api` 走网关。
60
+ `/bc-api` 交互选接口后经网关发起调用,请求体默认使用各文档「请求示例」;`GET` 接口无请求体。环境与鉴权取自变量配置文件,命令本身不接收参数。
80
61
 
81
62
  ```bash
82
- # iCenter 接口(默认生产环境 + 内置 API Key)
83
- sino-bc-cli /ic-api
84
-
85
63
  # 业务线接口
86
64
  sino-bc-cli /bc-api
87
65
 
88
- # 指定环境(test / pre / prod)
89
- sino-bc-cli /bc-api test
90
-
91
- # 指定环境和 API Key
92
- sino-bc-cli /bc-api pre sk-your-api-key
93
-
94
- # 选项写法
95
- sino-bc-cli /bc-api --env=test --api-key=sk-your-api-key
66
+ # 切换环境
67
+ sino-bc-cli /set-config env test
96
68
  ```
97
69
 
98
- | 参数 | 是否必传 | 默认值 | 说明 |
99
- | --- | --- | --- | --- |
100
- | `ENV` | 否 | `prod` | `test` / `pre` / `prod`,用于取 `src/constants/gateway.ts` 中的网关地址 |
101
- | `API_KEY` | 否 | `src/constants/gateway.ts` 的 `DEFAULT_API_KEY` | 注入请求头 `Authorization: Bearer ${API_KEY}`;同时固定注入 `X-GATEWAY-TYPE: A2C-CLI` |
102
-
103
- 执行后会按分组列出接口,输入序号后按所选环境网关发起调用,并打印响应。
70
+ | 配置 | 默认值 | 说明 |
71
+ | --- | --- | --- |
72
+ | `env` | `prod` | `test` / `pre` / `prod`,用于取 `src/constants/gateway.ts` 中的网关地址 |
73
+ | `API_KEY` | `src/constants/gateway.ts` 的 `DEFAULT_API_KEY` | 注入请求头 `Authorization: Bearer ${API_KEY}`;同时固定注入 `X-GATEWAY-TYPE: A2C-CLI` |