sino-bc-cli 1.8.2 → 1.8.4
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 +588 -624
- package/dist/SKILL.md +34 -26
- package/dist/affordance/biz-line.md +129 -63
- package/dist/affordance/sso.md +15 -0
- package/dist/api-doc/{README.md → custom/README.md} +92 -86
- package/dist/api-doc/system/biz-line-query.md +19 -0
- package/dist/api-doc/system/biz-line-strategy.md +285 -0
- package/dist/api-doc/system/sso.md +13 -0
- package/dist/generated/api-catalog.json +1063 -0
- package/dist/index.js +1 -1
- package/dist/skills/{sino-bc-shared → custom/sino-bc-shared}/SKILL.md +33 -39
- package/dist/skills/{sino-bc-shared → custom/sino-bc-shared}/references/config-and-env.md +15 -12
- package/dist/skills/{sino-bc-shared → custom/sino-bc-shared}/references/output-contract.md +20 -20
- package/dist/skills/{sino-bc-shared → custom/sino-bc-shared}/references/write-approval.md +18 -18
- package/dist/skills/{sino-bc-biz-line → system/sino-bc-biz-line}/SKILL.md +61 -64
- package/dist/skills/system/sino-bc-biz-line/references/long-tail-api.md +17 -0
- package/dist/skills/system/sino-bc-sso/SKILL.md +35 -0
- package/package.json +69 -69
- package/scripts/postinstall.cjs +28 -28
- package/dist/api-doc/biz-line-query.md +0 -218
- package/dist/api-doc/biz-line-strategy.md +0 -319
- package/dist/skills/sino-bc-biz-line/references/enums.md +0 -7
- package/dist/skills/sino-bc-biz-line/references/long-tail-api.md +0 -16
- package/dist/skills/sino-bc-shared/references/mcp-reload.md +0 -9
|
@@ -0,0 +1,1063 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"name": "biz-line-list",
|
|
4
|
+
"displayName": "查询业务线分页列表",
|
|
5
|
+
"description": "result 为公司分页对象:total=总条数,result=当前页的 BizLineListVO 列表。",
|
|
6
|
+
"group": "业务线策略",
|
|
7
|
+
"method": "POST",
|
|
8
|
+
"path": "/biz-line/list",
|
|
9
|
+
"timeout": 20000,
|
|
10
|
+
"tag": "业务线策略",
|
|
11
|
+
"domain": "biz-line",
|
|
12
|
+
"shortcut": "+list",
|
|
13
|
+
"risk": "read",
|
|
14
|
+
"summary": "查询业务线分页列表",
|
|
15
|
+
"docFile": "biz-line-strategy.md",
|
|
16
|
+
"requestSchema": {
|
|
17
|
+
"type": "object",
|
|
18
|
+
"properties": {
|
|
19
|
+
"pageNum": {
|
|
20
|
+
"type": "integer",
|
|
21
|
+
"format": "int32",
|
|
22
|
+
"description": "页码,从 1 开始",
|
|
23
|
+
"example": 1
|
|
24
|
+
},
|
|
25
|
+
"pageSize": {
|
|
26
|
+
"type": "integer",
|
|
27
|
+
"format": "int32",
|
|
28
|
+
"description": "每页条数",
|
|
29
|
+
"example": 20
|
|
30
|
+
},
|
|
31
|
+
"sortType": {
|
|
32
|
+
"type": "string",
|
|
33
|
+
"description": "排序字段(继承 PageRequest.sortType)。SPEND=按上期周消耗;WEEK_OVER_WEEK=按上期周消耗环比;PERIOD=按本期策略周期;TRAFFIC_LIGHT=按上期红绿灯。不传时默认按业务线 id 倒序",
|
|
34
|
+
"enum": [
|
|
35
|
+
"SPEND",
|
|
36
|
+
"WEEK_OVER_WEEK",
|
|
37
|
+
"PERIOD",
|
|
38
|
+
"TRAFFIC_LIGHT"
|
|
39
|
+
],
|
|
40
|
+
"example": "SPEND"
|
|
41
|
+
},
|
|
42
|
+
"sortDirection": {
|
|
43
|
+
"type": "string",
|
|
44
|
+
"description": "排序方向:ASC 升序,DESC 降序;默认 DESC",
|
|
45
|
+
"enum": [
|
|
46
|
+
"ASC",
|
|
47
|
+
"DESC"
|
|
48
|
+
],
|
|
49
|
+
"example": "DESC"
|
|
50
|
+
},
|
|
51
|
+
"name": {
|
|
52
|
+
"type": "string",
|
|
53
|
+
"description": "业务线名称,模糊搜索"
|
|
54
|
+
},
|
|
55
|
+
"status": {
|
|
56
|
+
"type": "integer",
|
|
57
|
+
"format": "int32",
|
|
58
|
+
"description": "状态:1=进行中 2=已完成 3=已暂停",
|
|
59
|
+
"example": 1
|
|
60
|
+
},
|
|
61
|
+
"ssoTeamCode": {
|
|
62
|
+
"type": "string",
|
|
63
|
+
"description": "组别 code,精确筛选(多选请用 ssoTeamCodeList)"
|
|
64
|
+
},
|
|
65
|
+
"ssoTeamCodeList": {
|
|
66
|
+
"type": "array",
|
|
67
|
+
"items": {
|
|
68
|
+
"type": "string"
|
|
69
|
+
},
|
|
70
|
+
"description": "组别 code 列表,多选"
|
|
71
|
+
},
|
|
72
|
+
"trafficLightList": {
|
|
73
|
+
"type": "array",
|
|
74
|
+
"items": {
|
|
75
|
+
"type": "integer",
|
|
76
|
+
"format": "int32"
|
|
77
|
+
},
|
|
78
|
+
"description": "红绿灯筛选(策略表现):1=绿灯KPI达标,2=黄灯距KPIGAP20%内,3=红灯距KPIGAP20%以上,4=红灯已暂停,5=黄灯存在风险,6=绿灯KPI达标且项目顺利。"
|
|
79
|
+
},
|
|
80
|
+
"adCategoryProjectId": {
|
|
81
|
+
"type": "integer",
|
|
82
|
+
"format": "int64",
|
|
83
|
+
"description": "投放品类:取接口biz-line-open-placement-categories"
|
|
84
|
+
},
|
|
85
|
+
"idList": {
|
|
86
|
+
"type": "array",
|
|
87
|
+
"items": {
|
|
88
|
+
"type": "integer",
|
|
89
|
+
"format": "int64"
|
|
90
|
+
},
|
|
91
|
+
"description": "业务线 ID 列表"
|
|
92
|
+
},
|
|
93
|
+
"pmUserIds": {
|
|
94
|
+
"type": "array",
|
|
95
|
+
"items": {
|
|
96
|
+
"type": "integer",
|
|
97
|
+
"format": "int32"
|
|
98
|
+
},
|
|
99
|
+
"description": "PM 用户 ID 多选(OR 语义:命中任一 PM)"
|
|
100
|
+
},
|
|
101
|
+
"projectRatingList": {
|
|
102
|
+
"type": "array",
|
|
103
|
+
"items": {
|
|
104
|
+
"type": "string"
|
|
105
|
+
},
|
|
106
|
+
"description": "项目评级多选:S、A、B、C"
|
|
107
|
+
},
|
|
108
|
+
"businessRegionList": {
|
|
109
|
+
"type": "array",
|
|
110
|
+
"items": {
|
|
111
|
+
"type": "string"
|
|
112
|
+
},
|
|
113
|
+
"description": "商务地区:EAST_CHINA=华东 SOUTH_CHINA=华南 NORTH_CHINA=华北"
|
|
114
|
+
},
|
|
115
|
+
"newCustomerTag": {
|
|
116
|
+
"type": "string",
|
|
117
|
+
"description": "新客标签单选,NEW_TAG = 新客 NONE_NEW_TAG = 非新客\n"
|
|
118
|
+
},
|
|
119
|
+
"weekOverWeekFilter": {
|
|
120
|
+
"type": "string",
|
|
121
|
+
"description": "周消耗环比筛选,DOWN_20 = 周消耗下降20%及以上"
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"name": "biz-line-detail",
|
|
128
|
+
"displayName": "业务线详情",
|
|
129
|
+
"description": "result 为 BizLineDetailVO。",
|
|
130
|
+
"group": "业务线策略",
|
|
131
|
+
"method": "POST",
|
|
132
|
+
"path": "/biz-line/detail",
|
|
133
|
+
"timeout": 20000,
|
|
134
|
+
"tag": "业务线策略",
|
|
135
|
+
"domain": "biz-line",
|
|
136
|
+
"shortcut": "+detail",
|
|
137
|
+
"risk": "read",
|
|
138
|
+
"summary": "业务线详情",
|
|
139
|
+
"docFile": "biz-line-strategy.md",
|
|
140
|
+
"requestSchema": {
|
|
141
|
+
"$ref": "#/components/schemas/BizLineDetailReqVO"
|
|
142
|
+
}
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
"name": "biz-line-save",
|
|
146
|
+
"displayName": "新建业务线",
|
|
147
|
+
"description": "⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。",
|
|
148
|
+
"group": "业务线策略",
|
|
149
|
+
"method": "POST",
|
|
150
|
+
"path": "/biz-line/save",
|
|
151
|
+
"timeout": 20000,
|
|
152
|
+
"tag": "业务线策略",
|
|
153
|
+
"domain": "biz-line",
|
|
154
|
+
"shortcut": "+save",
|
|
155
|
+
"risk": "write",
|
|
156
|
+
"summary": "新建业务线",
|
|
157
|
+
"docFile": "biz-line-strategy.md",
|
|
158
|
+
"requestSchema": {
|
|
159
|
+
"$ref": "#/components/schemas/BizLineSaveReqVO"
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"name": "biz-line-update",
|
|
164
|
+
"displayName": "编辑业务线",
|
|
165
|
+
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否更新成功。",
|
|
166
|
+
"group": "业务线策略",
|
|
167
|
+
"method": "POST",
|
|
168
|
+
"path": "/biz-line/update",
|
|
169
|
+
"timeout": 20000,
|
|
170
|
+
"tag": "业务线策略",
|
|
171
|
+
"domain": "biz-line",
|
|
172
|
+
"shortcut": "+update",
|
|
173
|
+
"risk": "write",
|
|
174
|
+
"summary": "编辑业务线",
|
|
175
|
+
"docFile": "biz-line-strategy.md",
|
|
176
|
+
"requestSchema": {
|
|
177
|
+
"$ref": "#/components/schemas/BizLineUpdateReqVO"
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
{
|
|
181
|
+
"name": "biz-line-status-update",
|
|
182
|
+
"displayName": "切换业务线状态",
|
|
183
|
+
"description": "⚠️ 写操作。仅更新状态与操作人;成功时 result 为 Boolean。status:1进行中 2已完成 3已暂停。",
|
|
184
|
+
"group": "业务线策略",
|
|
185
|
+
"method": "POST",
|
|
186
|
+
"path": "/biz-line/status/update",
|
|
187
|
+
"timeout": 20000,
|
|
188
|
+
"tag": "业务线策略",
|
|
189
|
+
"domain": "biz-line",
|
|
190
|
+
"shortcut": "+status",
|
|
191
|
+
"risk": "write",
|
|
192
|
+
"summary": "切换业务线状态",
|
|
193
|
+
"docFile": "biz-line-strategy.md",
|
|
194
|
+
"requestSchema": {
|
|
195
|
+
"$ref": "#/components/schemas/BizLineStatusUpdateReqVO"
|
|
196
|
+
}
|
|
197
|
+
},
|
|
198
|
+
{
|
|
199
|
+
"name": "biz-line-del",
|
|
200
|
+
"displayName": "删除业务线",
|
|
201
|
+
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否删除成功。",
|
|
202
|
+
"group": "业务线策略",
|
|
203
|
+
"method": "POST",
|
|
204
|
+
"path": "/biz-line/del",
|
|
205
|
+
"timeout": 20000,
|
|
206
|
+
"tag": "业务线策略",
|
|
207
|
+
"domain": "biz-line",
|
|
208
|
+
"shortcut": "+delete",
|
|
209
|
+
"risk": "high-risk-write",
|
|
210
|
+
"summary": "删除业务线",
|
|
211
|
+
"docFile": "biz-line-strategy.md",
|
|
212
|
+
"requestSchema": {
|
|
213
|
+
"$ref": "#/components/schemas/BizLineDelReqVO"
|
|
214
|
+
}
|
|
215
|
+
},
|
|
216
|
+
{
|
|
217
|
+
"name": "biz-line-strategy-period-list",
|
|
218
|
+
"displayName": "策略周期列表",
|
|
219
|
+
"description": "result 为 BizLineStrategyPeriodListVO,含 items 与 total。",
|
|
220
|
+
"group": "业务线策略",
|
|
221
|
+
"method": "POST",
|
|
222
|
+
"path": "/biz-line/strategy/period-list",
|
|
223
|
+
"timeout": 20000,
|
|
224
|
+
"tag": "业务线策略",
|
|
225
|
+
"domain": "biz-line",
|
|
226
|
+
"shortcut": "+period-list",
|
|
227
|
+
"risk": "read",
|
|
228
|
+
"summary": "策略周期列表",
|
|
229
|
+
"docFile": "biz-line-strategy.md",
|
|
230
|
+
"requestSchema": {
|
|
231
|
+
"$ref": "#/components/schemas/BizLineStrategyPeriodListReqVO"
|
|
232
|
+
}
|
|
233
|
+
},
|
|
234
|
+
{
|
|
235
|
+
"name": "biz-line-strategy-list",
|
|
236
|
+
"displayName": "查询策略分页列表",
|
|
237
|
+
"description": "result 为公司分页对象:total=总条数,result=当前页的 BizLineStrategyDetailVO 列表。",
|
|
238
|
+
"group": "业务线策略",
|
|
239
|
+
"method": "POST",
|
|
240
|
+
"path": "/biz-line/strategy/list",
|
|
241
|
+
"timeout": 20000,
|
|
242
|
+
"tag": "业务线策略",
|
|
243
|
+
"domain": "biz-line",
|
|
244
|
+
"shortcut": "+strategies",
|
|
245
|
+
"risk": "read",
|
|
246
|
+
"summary": "查询策略分页列表",
|
|
247
|
+
"docFile": "biz-line-strategy.md",
|
|
248
|
+
"requestSchema": {
|
|
249
|
+
"type": "object",
|
|
250
|
+
"properties": {
|
|
251
|
+
"pageNum": {
|
|
252
|
+
"type": "integer",
|
|
253
|
+
"format": "int32",
|
|
254
|
+
"description": "页码,从 1 开始",
|
|
255
|
+
"example": 1
|
|
256
|
+
},
|
|
257
|
+
"pageSize": {
|
|
258
|
+
"type": "integer",
|
|
259
|
+
"format": "int32",
|
|
260
|
+
"description": "每页条数",
|
|
261
|
+
"example": 20
|
|
262
|
+
},
|
|
263
|
+
"sortDirection": {
|
|
264
|
+
"type": "string",
|
|
265
|
+
"description": "DESC 或 ASC,默认 DESC",
|
|
266
|
+
"example": "DESC"
|
|
267
|
+
},
|
|
268
|
+
"bizLineId": {
|
|
269
|
+
"type": "integer",
|
|
270
|
+
"format": "int64",
|
|
271
|
+
"description": "业务线 ID",
|
|
272
|
+
"example": 1251
|
|
273
|
+
},
|
|
274
|
+
"trafficLight": {
|
|
275
|
+
"type": "integer",
|
|
276
|
+
"format": "int32",
|
|
277
|
+
"description": "红绿灯筛选(策略表现):1=绿灯KPI达标,2=黄灯距KPIGAP20%内,3=红灯距KPIGAP20%以上,4=红灯已暂停,5=黄灯存在风险,6=绿灯KPI达标且项目顺利。"
|
|
278
|
+
}
|
|
279
|
+
},
|
|
280
|
+
"required": [
|
|
281
|
+
"bizLineId"
|
|
282
|
+
]
|
|
283
|
+
}
|
|
284
|
+
},
|
|
285
|
+
{
|
|
286
|
+
"name": "biz-line-strategy-spend",
|
|
287
|
+
"displayName": "策略周期内关联项目周表消耗汇总",
|
|
288
|
+
"description": "result 为 BizLineStrategySpendVO,含 totalSpend。",
|
|
289
|
+
"group": "业务线策略",
|
|
290
|
+
"method": "POST",
|
|
291
|
+
"path": "/biz-line/strategy/spend",
|
|
292
|
+
"timeout": 20000,
|
|
293
|
+
"tag": "业务线策略",
|
|
294
|
+
"domain": "biz-line",
|
|
295
|
+
"shortcut": "+spend",
|
|
296
|
+
"risk": "read",
|
|
297
|
+
"summary": "策略周期内关联项目周表消耗汇总",
|
|
298
|
+
"docFile": "biz-line-strategy.md",
|
|
299
|
+
"requestSchema": {
|
|
300
|
+
"$ref": "#/components/schemas/BizLineStrategySpendReqVO"
|
|
301
|
+
}
|
|
302
|
+
},
|
|
303
|
+
{
|
|
304
|
+
"name": "biz-line-strategy-save",
|
|
305
|
+
"displayName": "新建策略",
|
|
306
|
+
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否保存成功。",
|
|
307
|
+
"group": "业务线策略",
|
|
308
|
+
"method": "POST",
|
|
309
|
+
"path": "/biz-line/strategy/save",
|
|
310
|
+
"timeout": 20000,
|
|
311
|
+
"tag": "业务线策略",
|
|
312
|
+
"domain": "biz-line",
|
|
313
|
+
"shortcut": "+strategy-save",
|
|
314
|
+
"risk": "write",
|
|
315
|
+
"summary": "新建策略",
|
|
316
|
+
"docFile": "biz-line-strategy.md",
|
|
317
|
+
"requestSchema": {
|
|
318
|
+
"$ref": "#/components/schemas/BizLineStrategySaveReqVO"
|
|
319
|
+
}
|
|
320
|
+
},
|
|
321
|
+
{
|
|
322
|
+
"name": "biz-line-strategy-update",
|
|
323
|
+
"displayName": "编辑策略",
|
|
324
|
+
"description": "⚠️ 写操作。成功时 result 为 Boolean。version 为乐观锁;overwrite=true 强制覆盖。",
|
|
325
|
+
"group": "业务线策略",
|
|
326
|
+
"method": "POST",
|
|
327
|
+
"path": "/biz-line/strategy/update",
|
|
328
|
+
"timeout": 20000,
|
|
329
|
+
"tag": "业务线策略",
|
|
330
|
+
"domain": "biz-line",
|
|
331
|
+
"shortcut": "+strategy-update",
|
|
332
|
+
"risk": "write",
|
|
333
|
+
"summary": "编辑策略",
|
|
334
|
+
"docFile": "biz-line-strategy.md",
|
|
335
|
+
"requestSchema": {
|
|
336
|
+
"$ref": "#/components/schemas/BizLineStrategyUpdateReqVO"
|
|
337
|
+
}
|
|
338
|
+
},
|
|
339
|
+
{
|
|
340
|
+
"name": "biz-line-strategy-del",
|
|
341
|
+
"displayName": "删除策略",
|
|
342
|
+
"description": "⚠️ 写操作。成功时 result 为 Boolean,表示是否删除成功。",
|
|
343
|
+
"group": "业务线策略",
|
|
344
|
+
"method": "POST",
|
|
345
|
+
"path": "/biz-line/strategy/del",
|
|
346
|
+
"timeout": 20000,
|
|
347
|
+
"tag": "业务线策略",
|
|
348
|
+
"domain": "biz-line",
|
|
349
|
+
"shortcut": "+strategy-delete",
|
|
350
|
+
"risk": "high-risk-write",
|
|
351
|
+
"summary": "删除策略",
|
|
352
|
+
"docFile": "biz-line-strategy.md",
|
|
353
|
+
"requestSchema": {
|
|
354
|
+
"$ref": "#/components/schemas/BizLineStrategyDelReqVO"
|
|
355
|
+
}
|
|
356
|
+
},
|
|
357
|
+
{
|
|
358
|
+
"name": "biz-line-open-channels",
|
|
359
|
+
"displayName": "查询投放渠道列表",
|
|
360
|
+
"description": "无入参,返回 ChannelEnum 全量:code = 枚举 id(即 list 的 mediaChannelId),name = 渠道名称。",
|
|
361
|
+
"group": "业务线查询",
|
|
362
|
+
"method": "GET",
|
|
363
|
+
"path": "/biz-line-open/channels",
|
|
364
|
+
"timeout": 20000,
|
|
365
|
+
"tag": "业务线查询",
|
|
366
|
+
"domain": "biz-line",
|
|
367
|
+
"shortcut": "+channels",
|
|
368
|
+
"risk": "read",
|
|
369
|
+
"summary": "查询投放渠道列表",
|
|
370
|
+
"docFile": "biz-line-query.md"
|
|
371
|
+
},
|
|
372
|
+
{
|
|
373
|
+
"name": "biz-line-open-placement-categories",
|
|
374
|
+
"displayName": "查询投放品类字典树",
|
|
375
|
+
"description": "无入参,sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业,二级节点(children)= 投放品类,分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。",
|
|
376
|
+
"group": "业务线查询",
|
|
377
|
+
"method": "GET",
|
|
378
|
+
"path": "/biz-line-open/placement-categories",
|
|
379
|
+
"timeout": 20000,
|
|
380
|
+
"tag": "业务线查询",
|
|
381
|
+
"domain": "biz-line",
|
|
382
|
+
"shortcut": "+categories",
|
|
383
|
+
"risk": "read",
|
|
384
|
+
"summary": "查询投放品类字典树",
|
|
385
|
+
"docFile": "biz-line-query.md"
|
|
386
|
+
},
|
|
387
|
+
{
|
|
388
|
+
"name": "sso-team-group-list",
|
|
389
|
+
"displayName": "查询组别列表",
|
|
390
|
+
"description": "无入参。返回 SSO 组别全量:code = teamCode(业务线 ssoTeamCode / ssoTeamCodeList),name = 组别名称。AccessContext 由网关注入,不出现在协议里。",
|
|
391
|
+
"group": "业务线策略",
|
|
392
|
+
"method": "GET",
|
|
393
|
+
"path": "/sso-team/group-list",
|
|
394
|
+
"timeout": 20000,
|
|
395
|
+
"tag": "业务线策略",
|
|
396
|
+
"domain": "sso",
|
|
397
|
+
"shortcut": "+group-list",
|
|
398
|
+
"risk": "read",
|
|
399
|
+
"summary": "查询组别列表",
|
|
400
|
+
"docFile": "sso.md"
|
|
401
|
+
},
|
|
402
|
+
{
|
|
403
|
+
"name": "icenter-mcp-strategy-dimension-facebook-ad-list",
|
|
404
|
+
"displayName": "Facebook广告策略维度数据",
|
|
405
|
+
"description": "查询 Facebook(Meta)渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等),用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「Facebook广告策略成效数据」接口。\n\n国家维度特别说明:country_code 必须单独传入,不能和任何其他维度同时传,否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口,只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射,用于给用户展示列名。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
406
|
+
"group": "业务线策略",
|
|
407
|
+
"method": "POST",
|
|
408
|
+
"path": "/icenter/mcp/strategy/dimension/facebook/ad/list",
|
|
409
|
+
"timeout": 20000,
|
|
410
|
+
"tag": "业务线策略",
|
|
411
|
+
"domain": "biz-line",
|
|
412
|
+
"shortcut": "+facebook-dimension",
|
|
413
|
+
"risk": "read",
|
|
414
|
+
"summary": "Facebook广告策略维度数据",
|
|
415
|
+
"docFile": "biz-line-strategy.md",
|
|
416
|
+
"requestSchema": {
|
|
417
|
+
"type": "object",
|
|
418
|
+
"properties": {
|
|
419
|
+
"startDate": {
|
|
420
|
+
"type": "string",
|
|
421
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
422
|
+
},
|
|
423
|
+
"endDate": {
|
|
424
|
+
"type": "string",
|
|
425
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31"
|
|
426
|
+
},
|
|
427
|
+
"dimensionValues": {
|
|
428
|
+
"type": "object",
|
|
429
|
+
"description": "过滤条件,仅支持 account_id 一个 key,传其他 key 会报错",
|
|
430
|
+
"properties": {
|
|
431
|
+
"account_id": {
|
|
432
|
+
"type": "array",
|
|
433
|
+
"items": {
|
|
434
|
+
"type": "string"
|
|
435
|
+
},
|
|
436
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
437
|
+
}
|
|
438
|
+
},
|
|
439
|
+
"required": [
|
|
440
|
+
"account_id"
|
|
441
|
+
]
|
|
442
|
+
},
|
|
443
|
+
"dimensions": {
|
|
444
|
+
"type": "array",
|
|
445
|
+
"items": {
|
|
446
|
+
"type": "string",
|
|
447
|
+
"enum": [
|
|
448
|
+
"calendar_date",
|
|
449
|
+
"account_id",
|
|
450
|
+
"account_name",
|
|
451
|
+
"campaign_id",
|
|
452
|
+
"campaign_name",
|
|
453
|
+
"adgroup_id",
|
|
454
|
+
"adgroup_name",
|
|
455
|
+
"ad_id",
|
|
456
|
+
"ad_name",
|
|
457
|
+
"bid_amount",
|
|
458
|
+
"objective",
|
|
459
|
+
"optimization_goal",
|
|
460
|
+
"ad_format",
|
|
461
|
+
"bid_strategy",
|
|
462
|
+
"audience_type",
|
|
463
|
+
"targeting_interests",
|
|
464
|
+
"targeting_flexible_interests",
|
|
465
|
+
"targeting_exclusion_interests",
|
|
466
|
+
"targeting_age",
|
|
467
|
+
"targeting_genders",
|
|
468
|
+
"country_code"
|
|
469
|
+
]
|
|
470
|
+
},
|
|
471
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、bid_amount(调整出价)、objective(广告目标)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_interests(兴趣词包)、targeting_flexible_interests(弹性兴趣词包)、targeting_exclusion_interests(排除兴趣词包)、targeting_age(年龄)、targeting_genders(性别)、country_code(国家,必须单独传,不能和其他维度同时传)"
|
|
472
|
+
},
|
|
473
|
+
"order": {
|
|
474
|
+
"type": "string",
|
|
475
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
476
|
+
},
|
|
477
|
+
"orderType": {
|
|
478
|
+
"type": "string",
|
|
479
|
+
"enum": [
|
|
480
|
+
"desc",
|
|
481
|
+
"asc"
|
|
482
|
+
],
|
|
483
|
+
"description": "排序方向,默认 asc"
|
|
484
|
+
},
|
|
485
|
+
"page": {
|
|
486
|
+
"type": "integer",
|
|
487
|
+
"description": "页码,从1开始,默认1"
|
|
488
|
+
},
|
|
489
|
+
"size": {
|
|
490
|
+
"type": "integer",
|
|
491
|
+
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
492
|
+
}
|
|
493
|
+
},
|
|
494
|
+
"required": [
|
|
495
|
+
"startDate",
|
|
496
|
+
"endDate",
|
|
497
|
+
"dimensionValues",
|
|
498
|
+
"dimensions"
|
|
499
|
+
]
|
|
500
|
+
}
|
|
501
|
+
},
|
|
502
|
+
{
|
|
503
|
+
"name": "icenter-mcp-strategy-dimension-google-ad-list",
|
|
504
|
+
"displayName": "Google广告策略维度数据",
|
|
505
|
+
"description": "查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等),用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度,出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「Google广告策略成效数据」接口。\n\n国家维度特别说明:country_code 必须单独传入,不能和任何其他维度同时传,否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口,只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射,用于给用户展示列名。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
506
|
+
"group": "业务线策略",
|
|
507
|
+
"method": "POST",
|
|
508
|
+
"path": "/icenter/mcp/strategy/dimension/google/ad/list",
|
|
509
|
+
"timeout": 20000,
|
|
510
|
+
"tag": "业务线策略",
|
|
511
|
+
"domain": "biz-line",
|
|
512
|
+
"shortcut": "+google-dimension",
|
|
513
|
+
"risk": "read",
|
|
514
|
+
"summary": "Google广告策略维度数据",
|
|
515
|
+
"docFile": "biz-line-strategy.md",
|
|
516
|
+
"requestSchema": {
|
|
517
|
+
"type": "object",
|
|
518
|
+
"properties": {
|
|
519
|
+
"startDate": {
|
|
520
|
+
"type": "string",
|
|
521
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
522
|
+
},
|
|
523
|
+
"endDate": {
|
|
524
|
+
"type": "string",
|
|
525
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31"
|
|
526
|
+
},
|
|
527
|
+
"dimensionValues": {
|
|
528
|
+
"type": "object",
|
|
529
|
+
"description": "过滤条件,仅支持 account_id 一个 key,传其他 key 会报错",
|
|
530
|
+
"properties": {
|
|
531
|
+
"account_id": {
|
|
532
|
+
"type": "array",
|
|
533
|
+
"items": {
|
|
534
|
+
"type": "string"
|
|
535
|
+
},
|
|
536
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
537
|
+
}
|
|
538
|
+
},
|
|
539
|
+
"required": [
|
|
540
|
+
"account_id"
|
|
541
|
+
]
|
|
542
|
+
},
|
|
543
|
+
"dimensions": {
|
|
544
|
+
"type": "array",
|
|
545
|
+
"items": {
|
|
546
|
+
"type": "string",
|
|
547
|
+
"enum": [
|
|
548
|
+
"calendar_date",
|
|
549
|
+
"account_id",
|
|
550
|
+
"account_name",
|
|
551
|
+
"campaign_id",
|
|
552
|
+
"campaign_name",
|
|
553
|
+
"adgroup_id",
|
|
554
|
+
"adgroup_name",
|
|
555
|
+
"ad_id",
|
|
556
|
+
"ad_name",
|
|
557
|
+
"optimization_goal",
|
|
558
|
+
"ad_format",
|
|
559
|
+
"bid_strategy",
|
|
560
|
+
"audience_type",
|
|
561
|
+
"targeting_age",
|
|
562
|
+
"targeting_genders",
|
|
563
|
+
"cpc_bid_amount",
|
|
564
|
+
"cpm_bid_amount",
|
|
565
|
+
"cpv_bid_amount",
|
|
566
|
+
"advertising_channel_type",
|
|
567
|
+
"keywords",
|
|
568
|
+
"country_code"
|
|
569
|
+
]
|
|
570
|
+
},
|
|
571
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、cpc_bid_amount(CPC出价)、cpm_bid_amount(CPM出价)、cpv_bid_amount(CPV出价)、advertising_channel_type(广告系列类型)、keywords(关键字)、country_code(国家,必须单独传,不能和其他维度同时传)"
|
|
572
|
+
},
|
|
573
|
+
"order": {
|
|
574
|
+
"type": "string",
|
|
575
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
576
|
+
},
|
|
577
|
+
"orderType": {
|
|
578
|
+
"type": "string",
|
|
579
|
+
"enum": [
|
|
580
|
+
"desc",
|
|
581
|
+
"asc"
|
|
582
|
+
],
|
|
583
|
+
"description": "排序方向,默认 asc"
|
|
584
|
+
},
|
|
585
|
+
"page": {
|
|
586
|
+
"type": "integer",
|
|
587
|
+
"description": "页码,从1开始,默认1"
|
|
588
|
+
},
|
|
589
|
+
"size": {
|
|
590
|
+
"type": "integer",
|
|
591
|
+
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
592
|
+
}
|
|
593
|
+
},
|
|
594
|
+
"required": [
|
|
595
|
+
"startDate",
|
|
596
|
+
"endDate",
|
|
597
|
+
"dimensionValues",
|
|
598
|
+
"dimensions"
|
|
599
|
+
]
|
|
600
|
+
}
|
|
601
|
+
},
|
|
602
|
+
{
|
|
603
|
+
"name": "icenter-mcp-strategy-dimension-tiktok-ad-list",
|
|
604
|
+
"displayName": "TikTok广告策略维度数据",
|
|
605
|
+
"description": "查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围,返回广告的策略设置明细(广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等),用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度,不含消耗、点击等成效指标,需要成效数据请改用「TikTok广告策略成效数据」接口。\n\n国家维度特别说明:country_code 必须单独传入,不能和任何其他维度同时传,否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口,只返回按国家分组的数据。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到中文列名的映射,用于给用户展示列名。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
606
|
+
"group": "业务线策略",
|
|
607
|
+
"method": "POST",
|
|
608
|
+
"path": "/icenter/mcp/strategy/dimension/tiktok/ad/list",
|
|
609
|
+
"timeout": 20000,
|
|
610
|
+
"tag": "业务线策略",
|
|
611
|
+
"domain": "biz-line",
|
|
612
|
+
"shortcut": "+tiktok-dimension",
|
|
613
|
+
"risk": "read",
|
|
614
|
+
"summary": "TikTok广告策略维度数据",
|
|
615
|
+
"docFile": "biz-line-strategy.md",
|
|
616
|
+
"requestSchema": {
|
|
617
|
+
"type": "object",
|
|
618
|
+
"properties": {
|
|
619
|
+
"startDate": {
|
|
620
|
+
"type": "string",
|
|
621
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
622
|
+
},
|
|
623
|
+
"endDate": {
|
|
624
|
+
"type": "string",
|
|
625
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31"
|
|
626
|
+
},
|
|
627
|
+
"dimensionValues": {
|
|
628
|
+
"type": "object",
|
|
629
|
+
"description": "过滤条件,仅支持 account_id 一个 key,传其他 key 会报错",
|
|
630
|
+
"properties": {
|
|
631
|
+
"account_id": {
|
|
632
|
+
"type": "array",
|
|
633
|
+
"items": {
|
|
634
|
+
"type": "string"
|
|
635
|
+
},
|
|
636
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
637
|
+
}
|
|
638
|
+
},
|
|
639
|
+
"required": [
|
|
640
|
+
"account_id"
|
|
641
|
+
]
|
|
642
|
+
},
|
|
643
|
+
"dimensions": {
|
|
644
|
+
"type": "array",
|
|
645
|
+
"items": {
|
|
646
|
+
"type": "string",
|
|
647
|
+
"enum": [
|
|
648
|
+
"calendar_date",
|
|
649
|
+
"account_id",
|
|
650
|
+
"account_name",
|
|
651
|
+
"campaign_id",
|
|
652
|
+
"campaign_name",
|
|
653
|
+
"adgroup_id",
|
|
654
|
+
"adgroup_name",
|
|
655
|
+
"ad_id",
|
|
656
|
+
"ad_name",
|
|
657
|
+
"bid_amount",
|
|
658
|
+
"objective",
|
|
659
|
+
"optimization_goal",
|
|
660
|
+
"ad_format",
|
|
661
|
+
"bid_strategy",
|
|
662
|
+
"audience_type",
|
|
663
|
+
"targeting_interests",
|
|
664
|
+
"targeting_age",
|
|
665
|
+
"targeting_genders",
|
|
666
|
+
"conversion_bid",
|
|
667
|
+
"deep_cpabid",
|
|
668
|
+
"country_code"
|
|
669
|
+
]
|
|
670
|
+
},
|
|
671
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、bid_amount(调整出价)、objective(广告目标)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_interests(兴趣词包)、targeting_age(年龄)、targeting_genders(性别)、conversion_bid(转化出价)、deep_cpabid(深度转化出价)、country_code(国家,必须单独传,不能和其他维度同时传)"
|
|
672
|
+
},
|
|
673
|
+
"order": {
|
|
674
|
+
"type": "string",
|
|
675
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
676
|
+
},
|
|
677
|
+
"orderType": {
|
|
678
|
+
"type": "string",
|
|
679
|
+
"enum": [
|
|
680
|
+
"desc",
|
|
681
|
+
"asc"
|
|
682
|
+
],
|
|
683
|
+
"description": "排序方向,默认 asc"
|
|
684
|
+
},
|
|
685
|
+
"page": {
|
|
686
|
+
"type": "integer",
|
|
687
|
+
"description": "页码,从1开始,默认1"
|
|
688
|
+
},
|
|
689
|
+
"size": {
|
|
690
|
+
"type": "integer",
|
|
691
|
+
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
692
|
+
}
|
|
693
|
+
},
|
|
694
|
+
"required": [
|
|
695
|
+
"startDate",
|
|
696
|
+
"endDate",
|
|
697
|
+
"dimensionValues",
|
|
698
|
+
"dimensions"
|
|
699
|
+
]
|
|
700
|
+
}
|
|
701
|
+
},
|
|
702
|
+
{
|
|
703
|
+
"name": "icenter-mcp-strategy-metrics-facebook-ad-list",
|
|
704
|
+
"displayName": "Facebook广告策略成效数据",
|
|
705
|
+
"description": "查询 Facebook(Meta)渠道广告的策略维度加成效指标数据。在广告策略配置(广告目标、成效目标、创意类型、出价方式、受众定向等)的分组下,返回消耗、曝光、点击、购买、安装等成效指标,用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,如 spend_usd 的值为 618.42,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,如 display_spend_usd 的值带货币符号,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射,维度列名为中文,指标列名为英文(如 spend_usd 对应 Spend)。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标,会被忽略且不报错,为空数组表示全部指标都生效。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
706
|
+
"group": "业务线策略",
|
|
707
|
+
"method": "POST",
|
|
708
|
+
"path": "/icenter/mcp/strategy/metrics/facebook/ad/list",
|
|
709
|
+
"timeout": 20000,
|
|
710
|
+
"tag": "业务线策略",
|
|
711
|
+
"domain": "biz-line",
|
|
712
|
+
"shortcut": "+facebook-metrics",
|
|
713
|
+
"risk": "read",
|
|
714
|
+
"summary": "Facebook广告策略成效数据",
|
|
715
|
+
"docFile": "biz-line-strategy.md",
|
|
716
|
+
"requestSchema": {
|
|
717
|
+
"type": "object",
|
|
718
|
+
"properties": {
|
|
719
|
+
"startDate": {
|
|
720
|
+
"type": "string",
|
|
721
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
722
|
+
},
|
|
723
|
+
"endDate": {
|
|
724
|
+
"type": "string",
|
|
725
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天"
|
|
726
|
+
},
|
|
727
|
+
"dimensionValues": {
|
|
728
|
+
"type": "object",
|
|
729
|
+
"description": "过滤条件,仅支持 account_id 一个 key,传其他 key 会报错",
|
|
730
|
+
"properties": {
|
|
731
|
+
"account_id": {
|
|
732
|
+
"type": "array",
|
|
733
|
+
"items": {
|
|
734
|
+
"type": "string"
|
|
735
|
+
},
|
|
736
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
737
|
+
}
|
|
738
|
+
},
|
|
739
|
+
"required": [
|
|
740
|
+
"account_id"
|
|
741
|
+
]
|
|
742
|
+
},
|
|
743
|
+
"dimensions": {
|
|
744
|
+
"type": "array",
|
|
745
|
+
"items": {
|
|
746
|
+
"type": "string",
|
|
747
|
+
"enum": [
|
|
748
|
+
"calendar_date",
|
|
749
|
+
"account_id",
|
|
750
|
+
"account_name",
|
|
751
|
+
"campaign_id",
|
|
752
|
+
"campaign_name",
|
|
753
|
+
"adgroup_id",
|
|
754
|
+
"adgroup_name",
|
|
755
|
+
"ad_id",
|
|
756
|
+
"ad_name",
|
|
757
|
+
"objective",
|
|
758
|
+
"optimization_goal",
|
|
759
|
+
"ad_format",
|
|
760
|
+
"bid_strategy",
|
|
761
|
+
"audience_type",
|
|
762
|
+
"targeting_interests",
|
|
763
|
+
"targeting_flexible_interests",
|
|
764
|
+
"targeting_exclusion_interests",
|
|
765
|
+
"targeting_age",
|
|
766
|
+
"targeting_genders"
|
|
767
|
+
]
|
|
768
|
+
},
|
|
769
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、objective(广告目标)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_interests(兴趣词包)、targeting_flexible_interests(弹性兴趣词包)、targeting_exclusion_interests(排除兴趣词包)、targeting_age(年龄)、targeting_genders(性别)"
|
|
770
|
+
},
|
|
771
|
+
"indicators": {
|
|
772
|
+
"type": "array",
|
|
773
|
+
"items": {
|
|
774
|
+
"type": "string",
|
|
775
|
+
"enum": [
|
|
776
|
+
"spend_usd",
|
|
777
|
+
"impressions",
|
|
778
|
+
"clicks",
|
|
779
|
+
"video_views",
|
|
780
|
+
"add_to_cart",
|
|
781
|
+
"checkouts",
|
|
782
|
+
"purchase",
|
|
783
|
+
"purchase_value",
|
|
784
|
+
"installs",
|
|
785
|
+
"complete_registration",
|
|
786
|
+
"leads",
|
|
787
|
+
"engagement"
|
|
788
|
+
]
|
|
789
|
+
},
|
|
790
|
+
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)"
|
|
791
|
+
},
|
|
792
|
+
"order": {
|
|
793
|
+
"type": "string",
|
|
794
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
795
|
+
},
|
|
796
|
+
"orderType": {
|
|
797
|
+
"type": "string",
|
|
798
|
+
"enum": [
|
|
799
|
+
"desc",
|
|
800
|
+
"asc"
|
|
801
|
+
],
|
|
802
|
+
"description": "排序方向,默认 asc"
|
|
803
|
+
},
|
|
804
|
+
"page": {
|
|
805
|
+
"type": "integer",
|
|
806
|
+
"description": "页码,从1开始,默认1"
|
|
807
|
+
},
|
|
808
|
+
"size": {
|
|
809
|
+
"type": "integer",
|
|
810
|
+
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
811
|
+
}
|
|
812
|
+
},
|
|
813
|
+
"required": [
|
|
814
|
+
"startDate",
|
|
815
|
+
"endDate",
|
|
816
|
+
"dimensionValues",
|
|
817
|
+
"dimensions",
|
|
818
|
+
"indicators"
|
|
819
|
+
]
|
|
820
|
+
}
|
|
821
|
+
},
|
|
822
|
+
{
|
|
823
|
+
"name": "icenter-mcp-strategy-metrics-google-ad-list",
|
|
824
|
+
"displayName": "Google广告策略成效数据",
|
|
825
|
+
"description": "查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置(成效目标、创意类型、出价方式、广告系列类型、关键字等)的分组下,返回消耗、曝光、点击、购买、安装等成效指标,用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,如 spend_usd 的值为 618.42,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,如 display_spend_usd 的值带货币符号,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射,维度列名为中文,指标列名为英文(如 spend_usd 对应 Spend)。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标,会被忽略且不报错,为空数组表示全部指标都生效。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
826
|
+
"group": "业务线策略",
|
|
827
|
+
"method": "POST",
|
|
828
|
+
"path": "/icenter/mcp/strategy/metrics/google/ad/list",
|
|
829
|
+
"timeout": 20000,
|
|
830
|
+
"tag": "业务线策略",
|
|
831
|
+
"domain": "biz-line",
|
|
832
|
+
"shortcut": "+google-metrics",
|
|
833
|
+
"risk": "read",
|
|
834
|
+
"summary": "Google广告策略成效数据",
|
|
835
|
+
"docFile": "biz-line-strategy.md",
|
|
836
|
+
"requestSchema": {
|
|
837
|
+
"type": "object",
|
|
838
|
+
"properties": {
|
|
839
|
+
"startDate": {
|
|
840
|
+
"type": "string",
|
|
841
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
842
|
+
},
|
|
843
|
+
"endDate": {
|
|
844
|
+
"type": "string",
|
|
845
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天"
|
|
846
|
+
},
|
|
847
|
+
"dimensionValues": {
|
|
848
|
+
"type": "object",
|
|
849
|
+
"description": "过滤条件,仅支持 account_id 一个 key,传其他 key 会报错",
|
|
850
|
+
"properties": {
|
|
851
|
+
"account_id": {
|
|
852
|
+
"type": "array",
|
|
853
|
+
"items": {
|
|
854
|
+
"type": "string"
|
|
855
|
+
},
|
|
856
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
857
|
+
}
|
|
858
|
+
},
|
|
859
|
+
"required": [
|
|
860
|
+
"account_id"
|
|
861
|
+
]
|
|
862
|
+
},
|
|
863
|
+
"dimensions": {
|
|
864
|
+
"type": "array",
|
|
865
|
+
"items": {
|
|
866
|
+
"type": "string",
|
|
867
|
+
"enum": [
|
|
868
|
+
"calendar_date",
|
|
869
|
+
"account_id",
|
|
870
|
+
"account_name",
|
|
871
|
+
"campaign_id",
|
|
872
|
+
"campaign_name",
|
|
873
|
+
"adgroup_id",
|
|
874
|
+
"adgroup_name",
|
|
875
|
+
"ad_id",
|
|
876
|
+
"ad_name",
|
|
877
|
+
"optimization_goal",
|
|
878
|
+
"ad_format",
|
|
879
|
+
"bid_strategy",
|
|
880
|
+
"audience_type",
|
|
881
|
+
"targeting_age",
|
|
882
|
+
"targeting_genders",
|
|
883
|
+
"cpc_bid_amount",
|
|
884
|
+
"cpm_bid_amount",
|
|
885
|
+
"cpv_bid_amount",
|
|
886
|
+
"advertising_channel_type",
|
|
887
|
+
"keywords"
|
|
888
|
+
]
|
|
889
|
+
},
|
|
890
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、cpc_bid_amount(CPC出价)、cpm_bid_amount(CPM出价)、cpv_bid_amount(CPV出价)、advertising_channel_type(广告系列类型)、keywords(关键字)"
|
|
891
|
+
},
|
|
892
|
+
"indicators": {
|
|
893
|
+
"type": "array",
|
|
894
|
+
"items": {
|
|
895
|
+
"type": "string",
|
|
896
|
+
"enum": [
|
|
897
|
+
"spend_usd",
|
|
898
|
+
"impressions",
|
|
899
|
+
"clicks",
|
|
900
|
+
"video_views",
|
|
901
|
+
"add_to_cart",
|
|
902
|
+
"checkouts",
|
|
903
|
+
"purchase",
|
|
904
|
+
"purchase_value",
|
|
905
|
+
"installs",
|
|
906
|
+
"complete_registration",
|
|
907
|
+
"leads",
|
|
908
|
+
"engagement"
|
|
909
|
+
]
|
|
910
|
+
},
|
|
911
|
+
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)"
|
|
912
|
+
},
|
|
913
|
+
"order": {
|
|
914
|
+
"type": "string",
|
|
915
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
916
|
+
},
|
|
917
|
+
"orderType": {
|
|
918
|
+
"type": "string",
|
|
919
|
+
"enum": [
|
|
920
|
+
"desc",
|
|
921
|
+
"asc"
|
|
922
|
+
],
|
|
923
|
+
"description": "排序方向,默认 asc"
|
|
924
|
+
},
|
|
925
|
+
"page": {
|
|
926
|
+
"type": "integer",
|
|
927
|
+
"description": "页码,从1开始,默认1"
|
|
928
|
+
},
|
|
929
|
+
"size": {
|
|
930
|
+
"type": "integer",
|
|
931
|
+
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
932
|
+
}
|
|
933
|
+
},
|
|
934
|
+
"required": [
|
|
935
|
+
"startDate",
|
|
936
|
+
"endDate",
|
|
937
|
+
"dimensionValues",
|
|
938
|
+
"dimensions",
|
|
939
|
+
"indicators"
|
|
940
|
+
]
|
|
941
|
+
}
|
|
942
|
+
},
|
|
943
|
+
{
|
|
944
|
+
"name": "icenter-mcp-strategy-metrics-tiktok-ad-list",
|
|
945
|
+
"displayName": "TikTok广告策略成效数据",
|
|
946
|
+
"description": "查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置(广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等)的分组下,返回消耗、曝光、点击、购买、安装等成效指标,用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。\n\n【返回格式】\nresult.data 为数据行数组,每行的每个字段有两个 key:\n一是原始值,key 即请求的 code,如 spend_usd 的值为 618.42,做计算或比较时用这个;\n二是展示值,key 加 display_ 前缀,如 display_spend_usd 的值带货币符号,直接呈现给用户时用这个,空值为 \"-\"。\nresult.headerMap 是字段 code 到列名的映射,维度列名为中文,指标列名为英文(如 spend_usd 对应 Spend)。\nresult.total 为总条数,result.page 和 result.size 为当前分页。\nresult.conflictField 是传入但当前渠道不支持的指标,会被忽略且不报错,为空数组表示全部指标都生效。\n外层 code 为 0 表示成功;非 0 时 result 为 null,失败原因在 message 字段里。",
|
|
947
|
+
"group": "业务线策略",
|
|
948
|
+
"method": "POST",
|
|
949
|
+
"path": "/icenter/mcp/strategy/metrics/tiktok/ad/list",
|
|
950
|
+
"timeout": 20000,
|
|
951
|
+
"tag": "业务线策略",
|
|
952
|
+
"domain": "biz-line",
|
|
953
|
+
"shortcut": "+tiktok-metrics",
|
|
954
|
+
"risk": "read",
|
|
955
|
+
"summary": "TikTok广告策略成效数据",
|
|
956
|
+
"docFile": "biz-line-strategy.md",
|
|
957
|
+
"requestSchema": {
|
|
958
|
+
"type": "object",
|
|
959
|
+
"properties": {
|
|
960
|
+
"startDate": {
|
|
961
|
+
"type": "string",
|
|
962
|
+
"description": "开始日期,格式 yyyy-MM-dd,例如 2026-08-01"
|
|
963
|
+
},
|
|
964
|
+
"endDate": {
|
|
965
|
+
"type": "string",
|
|
966
|
+
"description": "结束日期,格式 yyyy-MM-dd,例如 2026-08-31。最多支持查询近21天"
|
|
967
|
+
},
|
|
968
|
+
"dimensionValues": {
|
|
969
|
+
"type": "object",
|
|
970
|
+
"description": "过滤条件,仅支持 account_id 一个 key,传其他 key 会报错",
|
|
971
|
+
"properties": {
|
|
972
|
+
"account_id": {
|
|
973
|
+
"type": "array",
|
|
974
|
+
"items": {
|
|
975
|
+
"type": "string"
|
|
976
|
+
},
|
|
977
|
+
"description": "广告账户ID(带格式),必须带前缀,例如 act_1036928420879324。最多传500个"
|
|
978
|
+
}
|
|
979
|
+
},
|
|
980
|
+
"required": [
|
|
981
|
+
"account_id"
|
|
982
|
+
]
|
|
983
|
+
},
|
|
984
|
+
"dimensions": {
|
|
985
|
+
"type": "array",
|
|
986
|
+
"items": {
|
|
987
|
+
"type": "string",
|
|
988
|
+
"enum": [
|
|
989
|
+
"calendar_date",
|
|
990
|
+
"account_id",
|
|
991
|
+
"account_name",
|
|
992
|
+
"campaign_id",
|
|
993
|
+
"campaign_name",
|
|
994
|
+
"adgroup_id",
|
|
995
|
+
"adgroup_name",
|
|
996
|
+
"ad_id",
|
|
997
|
+
"ad_name",
|
|
998
|
+
"optimization_goal",
|
|
999
|
+
"ad_format",
|
|
1000
|
+
"bid_strategy",
|
|
1001
|
+
"audience_type",
|
|
1002
|
+
"targeting_age",
|
|
1003
|
+
"targeting_genders",
|
|
1004
|
+
"objective",
|
|
1005
|
+
"targeting_interests",
|
|
1006
|
+
"conversion_bid",
|
|
1007
|
+
"deep_cpabid"
|
|
1008
|
+
]
|
|
1009
|
+
},
|
|
1010
|
+
"description": "分组维度,必传且不能为空数组,否则返回结果为空。各维度含义:calendar_date(投放日期)、account_id(广告账户ID)、account_name(广告账户名称)、campaign_id(广告系列ID)、campaign_name(广告系列名称)、adgroup_id(广告组ID)、adgroup_name(广告组名称)、ad_id(广告ID)、ad_name(广告名称)、optimization_goal(成效目标)、ad_format(创意类型)、bid_strategy(出价方式)、audience_type(受众类型)、targeting_age(年龄)、targeting_genders(性别)、objective(广告目标)、targeting_interests(兴趣词包)、conversion_bid(转化出价)、deep_cpabid(深度转化出价)"
|
|
1011
|
+
},
|
|
1012
|
+
"indicators": {
|
|
1013
|
+
"type": "array",
|
|
1014
|
+
"items": {
|
|
1015
|
+
"type": "string",
|
|
1016
|
+
"enum": [
|
|
1017
|
+
"spend_usd",
|
|
1018
|
+
"impressions",
|
|
1019
|
+
"clicks",
|
|
1020
|
+
"video_views",
|
|
1021
|
+
"add_to_cart",
|
|
1022
|
+
"checkouts",
|
|
1023
|
+
"purchase",
|
|
1024
|
+
"purchase_value",
|
|
1025
|
+
"installs",
|
|
1026
|
+
"complete_registration",
|
|
1027
|
+
"leads",
|
|
1028
|
+
"engagement"
|
|
1029
|
+
]
|
|
1030
|
+
},
|
|
1031
|
+
"description": "成效指标,必传且不能为空数组。各指标含义:spend_usd(消耗金额,美元)、impressions(曝光量)、clicks(点击量)、video_views(视频观看次数)、add_to_cart(添加购物车次数)、checkouts(发起结账次数)、purchase(购买次数)、purchase_value(购买金额,美元)、installs(应用安装量)、complete_registration(完成注册量)、leads(留下潜客信息次数)、engagement(互动次数)"
|
|
1032
|
+
},
|
|
1033
|
+
"order": {
|
|
1034
|
+
"type": "string",
|
|
1035
|
+
"description": "排序字段,填单个 code,取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中,服务端会自动补入参与排序,但该字段不会作为列返回"
|
|
1036
|
+
},
|
|
1037
|
+
"orderType": {
|
|
1038
|
+
"type": "string",
|
|
1039
|
+
"enum": [
|
|
1040
|
+
"desc",
|
|
1041
|
+
"asc"
|
|
1042
|
+
],
|
|
1043
|
+
"description": "排序方向,默认 asc"
|
|
1044
|
+
},
|
|
1045
|
+
"page": {
|
|
1046
|
+
"type": "integer",
|
|
1047
|
+
"description": "页码,从1开始,默认1"
|
|
1048
|
+
},
|
|
1049
|
+
"size": {
|
|
1050
|
+
"type": "integer",
|
|
1051
|
+
"description": "每页条数,默认10,建议显式传且不超过1000"
|
|
1052
|
+
}
|
|
1053
|
+
},
|
|
1054
|
+
"required": [
|
|
1055
|
+
"startDate",
|
|
1056
|
+
"endDate",
|
|
1057
|
+
"dimensionValues",
|
|
1058
|
+
"dimensions",
|
|
1059
|
+
"indicators"
|
|
1060
|
+
]
|
|
1061
|
+
}
|
|
1062
|
+
}
|
|
1063
|
+
]
|