best-geo-test 0.3.0 → 0.3.2

package/capabilities/capabilities.json

@@ -369,6 +369,68 @@
         "additionalProperties": false
       }
     },
+    {
+      "name": "questions.linkKnowledge",
+      "mode": "write",
+      "guide": "question",
+      "requiresPlan": true,
+      "description": "给搜索问题绑定知识库。绑定之后，AI 写这个问题的文章时会去这些知识库里检索 —— 绑错了写出来的内容就跑偏。重复绑定会自动跳过。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "questionId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个搜索问题"
+          },
+          "knowledgeBaseIds": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "description": "要绑定的知识库 id，来自 knowledge.list"
+          }
+        },
+        "required": [
+          "questionId",
+          "knowledgeBaseIds"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "questions.unlinkKnowledge",
+      "mode": "write",
+      "guide": "question",
+      "requiresPlan": true,
+      "description": "解除搜索问题与知识库的绑定。解绑后 AI 写这个问题的文章时不再检索这些知识库。知识库本身不受影响，还在。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "questionId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个搜索问题"
+          },
+          "knowledgeBaseIds": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "description": "要解绑的知识库 id"
+          }
+        },
+        "required": [
+          "questionId",
+          "knowledgeBaseIds"
+        ],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "articles.list",
       "mode": "read",
@@ -392,7 +454,11 @@
           },
           "status": {
             "type": "integer",
-            "description": "按文章状态过滤。取值：0=待审核，1=已通过，2=已拒绝。不传就是全部状态。"
+            "description": "按文章状态过滤。取值：0=待审核，1=已通过，2=已拒绝。不传就是全部状态。要找能发出去的文章就传 1。"
+          },
+          "mustHaveCover": {
+            "type": "boolean",
+            "description": "只看有封面图的。要挑文章去发布或投稿时，配上 status=1 一起传，出来的就都是发得出去的——不然查到一篇没封面的，建任务时才被拒。"
           },
           "published": {
             "type": "boolean",
@@ -498,7 +564,7 @@
       "mode": "write",
       "guide": "article",
       "requiresPlan": true,
-      "description": "改一篇已有文章。改不了所属项目和文件夹——那两个要去网页改。不扣费。",
+      "description": "改一篇已有文章的标题、正文、封面、标签、摘要。改不了所属 GEO 项目——那个要去网页改；换文件夹用 articles.moveFolder，改状态用 articles.setStatus。不扣费。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -542,6 +608,95 @@
         "additionalProperties": false
       }
     },
+    {
+      "name": "folders.list",
+      "mode": "read",
+      "guide": "article",
+      "requiresPlan": false,
+      "description": "列出文章文件夹(扁平,自己按 parentId 拼树)。要把文章放进指定文件夹、或要回答「这篇在哪个文件夹」时，先查这里拿 id —— 不要猜 id，猜错会被服务端拒掉、白跑一次 plan。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "companyId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某家公司的"
+          },
+          "productId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某个 GEO 项目的。建文章前一般都该带上它"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articles.moveFolder",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "把一篇或多篇文章移到另一个文件夹。只能移到同一个 GEO 项目下的文件夹，跨项目会被拒。不改文章内容，也不扣费。目标文件夹的 id 来自 folders.list。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleIds": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "description": "要移动的文章 id，一次可以给多个"
+          },
+          "folderId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "移到哪个文件夹，来自 folders.list"
+          }
+        },
+        "required": [
+          "articleIds",
+          "folderId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articles.setStatus",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "批量改文章的审核状态。不改文章内容，也不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleIds": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "description": "要改的文章 id，一次可以给多个"
+          },
+          "status": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2
+            ],
+            "description": "0=待审核，1=已通过，2=已拒绝"
+          }
+        },
+        "required": [
+          "articleIds",
+          "status"
+        ],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "knowledge.list",
       "mode": "read",
@@ -690,6 +845,51 @@
         "additionalProperties": false
       }
     },
+    {
+      "name": "knowledge.addFiles",
+      "mode": "write",
+      "guide": "knowledge",
+      "requiresPlan": true,
+      "description": "往一个已有知识库里再加文档。用户说「把这份资料补进 XX 知识库」时用它 —— 不要另建一个库，同一个主题散成好几个库反而让检索更差。按文档计费，执行时才扣。加进去要后台解析一会儿才检索得到。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "knowledgeBaseId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "加到哪个知识库，来自 knowledge.list"
+          },
+          "files": {
+            "type": "array",
+            "description": "至少一个文档。每个文档扣一次费。",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "文档名，展示用",
+                  "maxLength": 255
+                },
+                "file": {
+                  "type": "string",
+                  "description": "可以是链接，也可以直接是整段正文文本"
+                }
+              },
+              "required": [
+                "name",
+                "file"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "knowledgeBaseId",
+          "files"
+        ],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "images.list",
       "mode": "read",
@@ -2217,6 +2417,1262 @@
         ],
         "additionalProperties": false
       }
+    },
+    {
+      "name": "scheduledIndexing.answers",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时收录：每一次提问的记录，含 AI 回答原文。metrics 只给数字（提及率、平均排名），这里给的是**AI 到底怎么说的**——要回答「豆包最近怎么评价我们」「它推荐了哪几家」就查这里。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "platform": {
+            "type": "string",
+            "description": "只看某个 AI 平台。取值来自 indexingPlatforms.list"
+          },
+          "topicId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一条搜索问题"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "withContent": {
+            "type": "boolean",
+            "description": "要不要 AI 回答的全文。**默认不给**，只给前 200 字预览 —— 一条回答动辄上千字，一页 20 条就能把上下文占满。先看预览，确实要读全文再对那几条单独传 true"
+          },
+          "page": {
+            "type": "integer",
+            "default": 1,
+            "description": "第几页"
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20,
+            "maximum": 100,
+            "description": "每页几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledIndexing.citations",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时收录：AI 答题时引用了哪些来源。channels 按站点聚合、contents 按具体网页聚合，各带次数与占比。这个直接回答「该往哪儿发内容」——AI 常引谁，就该去谁那儿发。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "aiPlatform": {
+            "type": "string",
+            "description": "只看某个 AI 平台。取值来自 indexingPlatforms.list"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "limit": {
+            "type": "integer",
+            "maximum": 100,
+            "description": "最多给几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledIndexing.topicStats",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时收录：按问题维度的表现——哪几句问出来有效果、哪几句一次都没提到我们。带提及率和被提到时的平均排名（越小越靠前）。用来决定下一轮该换掉哪些问题。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "platform": {
+            "type": "string",
+            "description": "只看某个 AI 平台。取值来自 indexingPlatforms.list"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "page": {
+            "type": "integer",
+            "default": 1,
+            "description": "第几页"
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20,
+            "maximum": 100,
+            "description": "每页几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledIndexing.topicPlatformMatrix",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时收录：问题 × 平台矩阵，一眼看出哪个平台在哪个问题上提到了我们。每行还带这个问题下 AI 引到的媒体源。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "page": {
+            "type": "integer",
+            "default": 1,
+            "description": "第几页"
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20,
+            "maximum": 100,
+            "description": "每页几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledSentiment.answers",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时舆情：每一次提问的记录，含 AI 回答原文。要回答「AI 具体是怎么评价我们的」就查这里，metrics 只给褒贬词的汇总。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "platform": {
+            "type": "string",
+            "description": "只看某个 AI 平台。取值来自 indexingPlatforms.list"
+          },
+          "question": {
+            "type": "string",
+            "description": "只看某一句问句"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "withContent": {
+            "type": "boolean",
+            "description": "要不要 AI 回答的全文。**默认不给**，只给前 200 字预览 —— 一条回答动辄上千字，一页 20 条就能把上下文占满。先看预览，确实要读全文再对那几条单独传 true"
+          },
+          "page": {
+            "type": "integer",
+            "default": 1,
+            "description": "第几页"
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20,
+            "maximum": 100,
+            "description": "每页几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledSentiment.citations",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时舆情：AI 答题时引用了哪些来源。口径与收录那套相同。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "aiPlatform": {
+            "type": "string",
+            "description": "只看某个 AI 平台。取值来自 indexingPlatforms.list"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "limit": {
+            "type": "integer",
+            "maximum": 100,
+            "description": "最多给几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledSentiment.topicStats",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "定时舆情：问句 × 平台矩阵。注意它和收录的 topicStats **不是一回事**——舆情这边一行是一句问句加各平台的状态，没有提及率和排名那套数字。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "planId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个计划"
+          },
+          "platform": {
+            "type": "string",
+            "description": "只看某个 AI 平台。取值来自 indexingPlatforms.list"
+          },
+          "runId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某一次执行。不传就是跨所有执行"
+          },
+          "startDate": {
+            "type": "string",
+            "description": "起始日期，ISO 字符串，如 2026-08-01"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "结束日期，ISO 字符串，如 2026-08-31"
+          },
+          "page": {
+            "type": "integer",
+            "default": 1,
+            "description": "第几页"
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20,
+            "maximum": 100,
+            "description": "每页几条"
+          }
+        },
+        "required": [
+          "planId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "scheduledSentiment.generateQuestions",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "让 AI 想一批舆情问句。**不写库也不扣费**，所以是查询不是写操作——拿到候选之后，挑好的填进 scheduledSentiment.create 的 questions。项目必须先配好品牌词。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "companyId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪家公司"
+          },
+          "productId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个 GEO 项目，必须已配置品牌词"
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "default": 10,
+            "description": "生成几条，1-20"
+          }
+        },
+        "required": [
+          "companyId",
+          "productId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "indexing.suggestCompetitors",
+      "mode": "read",
+      "guide": "scheduled-monitor",
+      "requiresPlan": false,
+      "description": "让 AI 推荐这家公司的竞品品牌名。**不写库也不扣费**。拿到之后挑几个填进 scheduledIndexing.create 的 competitorBrands。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "companyId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪家公司"
+          }
+        },
+        "required": [
+          "companyId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articles.generateSummaries",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "让 AI 给一篇文章生成几条摘要。**按次扣费**，所以要走确认。标题正文由服务端从库里读，不用你传。生成结果只回给你看，**不会自动写进文章**——用户认可之后再用 articles.update 存进去。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "给哪篇文章生成。这篇必须已经有正文"
+          }
+        },
+        "required": [
+          "articleId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "keywordTasks.list",
+      "mode": "read",
+      "guide": "question-task",
+      "requiresPlan": false,
+      "description": "列出关键词拓展任务，看跑到哪一步了。建完任务用它查状态——L1 要跑一会儿才出词。不含拓出来的词，要看结果用 keywordTasks.get。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "companyId": {
+            "type": "integer",
+            "description": "只看某家公司；不传就是全部授权公司"
+          },
+          "productId": {
+            "type": "integer",
+            "description": "只看某个 GEO 项目"
+          },
+          "id": {
+            "type": "integer",
+            "description": "只看某一个任务"
+          },
+          "name": {
+            "type": "string",
+            "description": "按任务名前缀匹配"
+          },
+          "keyword": {
+            "type": "string",
+            "description": "按拓展起点词前缀匹配"
+          },
+          "stageStatus": {
+            "type": "integer",
+            "description": "按当前阶段的状态过滤。0=待处理，1=生成中，2=已完成，3=失败",
+            "enum": [
+              0,
+              1,
+              2,
+              3
+            ]
+          },
+          "page": {
+            "type": "integer",
+            "default": 1
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20,
+            "maximum": 100
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "keywordTasks.get",
+      "mode": "read",
+      "guide": "question-task",
+      "requiresPlan": false,
+      "description": "读一个关键词拓展任务，含各阶段拓出来的词。要做 keywordTasks.expandL2 必须先读这一条——挑词传的就是 result[0].output 里的字符串。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": {
+            "type": "integer",
+            "minimum": 1
+          }
+        },
+        "required": [
+          "taskId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "keywordTasks.create",
+      "mode": "write",
+      "guide": "question-task",
+      "requiresPlan": true,
+      "description": "新建关键词多阶段拓展任务（L1）。和 questionTasks 不是一回事：那个一次性生成一批搜索问题，这个是分阶段的关键词树——先出 L1 一批词，用户挑几个，再拓 L2。按任务扣一次费，后面的 L2 不再扣。执行是异步的。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "maxLength": 100,
+            "description": "任务名"
+          },
+          "productId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "归哪个 GEO 项目"
+          },
+          "keyword": {
+            "type": "string",
+            "description": "从哪个词拓开"
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "要拓多少个词，1-50"
+          },
+          "userPrompt": {
+            "type": "string",
+            "maxLength": 500,
+            "description": "给 AI 的额外要求，指导输出方向"
+          }
+        },
+        "required": [
+          "name",
+          "productId",
+          "keyword",
+          "count"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "keywordTasks.updateL1",
+      "mode": "write",
+      "guide": "question-task",
+      "requiresPlan": true,
+      "description": "改写关键词拓展任务的 L1 结果——AI 出的词不满意时，直接把整批换成你要的。不扣费。改完再做 L2 拓展。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个任务"
+          },
+          "output": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            },
+            "description": "新的 L1 词表，整体覆盖"
+          }
+        },
+        "required": [
+          "taskId",
+          "output"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "keywordTasks.expandL2",
+      "mode": "write",
+      "guide": "question-task",
+      "requiresPlan": true,
+      "description": "从 L1 结果里挑几个词，拓展到 L2。不扣费，但**只能做一次**——重复触发会覆盖已经跑出来的 L3 结果，服务端会直接拒绝。挑词之前先跟用户确认清楚。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "哪个任务"
+          },
+          "selected": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            },
+            "description": "从 L1 结果里挑中的词"
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "每个词拓多少，1-50"
+          },
+          "userPrompt": {
+            "type": "string",
+            "maxLength": 500,
+            "description": "给 AI 的额外要求，指导输出方向"
+          }
+        },
+        "required": [
+          "taskId",
+          "selected",
+          "count"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "tags.list",
+      "mode": "read",
+      "guide": "article",
+      "requiresPlan": false,
+      "description": "某个域下已经用过的标签清单。要按标签筛选、或者给新内容打标签时先查这里——用已有的标签，别每次造新词，不然标签体系很快就散了。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "domain": {
+            "type": "string",
+            "enum": [
+              "article",
+              "knowledge",
+              "image",
+              "video",
+              "prompt",
+              "question"
+            ],
+            "description": "查哪个域的标签：article=文章，knowledge=知识库，image=图片，video=视频，prompt=提示词，question=搜索问题"
+          },
+          "companyId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某家公司的"
+          },
+          "productId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "只看某个 GEO 项目的"
+          }
+        },
+        "required": [
+          "domain"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "prompts.create",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "新建提示词（写作模板）。只能建「文章正文」和「文章标题」两类——和 prompts.list 同口径，建了别的类型你自己也查不到。建出来不扣费，也不会自动用到任何文章上。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "maxLength": 100,
+            "description": "提示词名称"
+          },
+          "companyId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "归哪家公司"
+          },
+          "productId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "可选：绑定到某个 GEO 项目下"
+          },
+          "content": {
+            "type": "string",
+            "maxLength": 20000,
+            "description": "提示词正文"
+          },
+          "negativeContent": {
+            "type": "string",
+            "description": "反向提示词：不希望 AI 怎么写"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "标签，取值先查 tags.list"
+          },
+          "type": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "1=文章正文，2=文章标题"
+          }
+        },
+        "required": [
+          "name",
+          "companyId",
+          "content",
+          "type"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "prompts.update",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "改一条提示词，只传要改的字段。改不了所属公司和项目。**系统内置的公共模板改不了**——要按自己的写法调整，用 prompts.create 复制一份新建。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "promptId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "改哪条"
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 100
+          },
+          "content": {
+            "type": "string",
+            "maxLength": 20000
+          },
+          "negativeContent": {
+            "type": "string"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "type": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "1=文章正文，2=文章标题"
+          }
+        },
+        "required": [
+          "promptId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articles.copy",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "复制一篇文章。复制出来的是一篇独立的新文章，**按新建文章扣一次费**，执行时才扣。改副本不影响原文。想「照着这篇再写一篇」时用它。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "复制哪一篇"
+          }
+        },
+        "required": [
+          "articleId"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "questions.delete",
+      "mode": "write",
+      "guide": "question",
+      "requiresPlan": true,
+      "description": "删除搜索问题。已经跑出来的收录记录不受影响，只是这个问题以后不再被问。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "要删哪一条"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articles.delete",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "删除文章。删了就没了，**不可恢复**。已经发布出去的内容不受影响。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "要删哪一条"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "knowledge.delete",
+      "mode": "write",
+      "guide": "knowledge",
+      "requiresPlan": true,
+      "description": "删除知识库。库里文档一起删掉，**不可恢复**。绑定了这个库的搜索问题会失去这份资料。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "要删哪一条"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "prompts.delete",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "删除提示词。已经用它生成过的文章不受影响。系统内置的公共模板删不了。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "要删哪一条"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationPlatforms.list",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "当前能用的自媒体发布平台。文章平台和视频平台是两批，建发布任务前先按 contentType 取对应的那批——拿文章平台去发视频会被拒。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "contentType": {
+            "type": "string",
+            "enum": ["article", "video"],
+            "description": "只看发文章的还是只看发视频的。不传就是全部"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationAccounts.list",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "已经绑定到公司的发布账号。平台名猜得出来，账号 id 猜不出来——要发内容必须先从这里拿到 id。**只挑 usable=true 的号**：登录过期或已停用的号建任务时会被拒（statusLabel 会写明是哪种），在这一步避开比建完被拒再回头省事。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "companyId": { "type": "integer", "minimum": 1, "description": "只看某家公司的" },
+          "platform": { "type": "string", "description": "只看某个平台的。取值来自 publicationPlatforms.list" },
+          "page": { "type": "integer", "minimum": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationTasks.list",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "自媒体发布任务列表。一个任务下面挂着若干条「某篇内容发到某个平台某个账号」的记录，这里只给任务级汇总，要看每条的下场用 publicationRecords.list。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "companyId": { "type": "integer", "minimum": 1, "description": "只看某家公司的" },
+          "productId": { "type": "integer", "minimum": 1, "description": "只看某个 GEO 项目的" },
+          "name": { "type": "string", "description": "按任务名模糊搜" },
+          "page": { "type": "integer", "minimum": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationRecords.list",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "发布记录：每条内容在每个平台的实际下场。这是「发出去了没有、发到哪个链接、失败为什么」的唯一出处——用户问「小红书那篇发了吗」就查这里。status 同时给数值和 statusLabel，念给用户用后者。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": { "type": "integer", "minimum": 1, "description": "只看某个发布任务下的" },
+          "articleId": { "type": "integer", "minimum": 1, "description": "只看某篇文章的" },
+          "platform": { "type": "string", "description": "只看某个平台的" },
+          "status": { "type": "integer", "description": "0待发布 1发布中 2已发布 3失败 4已暂停 5已取消 6人工 7被拒" },
+          "companyId": { "type": "integer", "minimum": 1 },
+          "productId": { "type": "integer", "minimum": 1 },
+          "page": { "type": "integer", "minimum": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "mediaPlatforms.list",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "可投稿的媒体清单，含分类、地区、价格和上下架状态。媒体投稿和自媒体发布是两回事：这个是花钱请媒体发，那个是用自己的账号发。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "mediaName": { "type": "string", "description": "按媒体名搜" },
+          "page": { "type": "integer", "minimum": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "mediaPlatforms.get",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "单个媒体的实时状态与当前价格。**报价给用户前必须查这条**——列表是分页快照，遇上刚调过价就会和实际扣费对不上。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "mediaId": { "type": "integer", "minimum": 1, "description": "哪个媒体。id 来自 mediaPlatforms.list" }
+        },
+        "required": ["mediaId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "mediaPublications.list",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "媒体投稿记录：订单状态、失败原因、发布链接、退款状态。投稿是异步的，提交完要过一阵才出结果，用这条查进展。**status 和 refundStatus 是两件事**——status 说稿子发出去没有，refundStatus 说钱退没退；被拒稿的记录要把两个都念给用户。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleId": { "type": "integer", "minimum": 1, "description": "只看某篇文章投出去的" },
+          "mediaId": { "type": "integer", "minimum": 1, "description": "只看投到某个媒体的" },
+          "companyId": { "type": "integer", "minimum": 1 },
+          "page": { "type": "integer", "minimum": 1 },
+          "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "mediaPublications.summary",
+      "mode": "read",
+      "guide": "publication",
+      "requiresPlan": false,
+      "description": "投稿记录的状态汇总。要回答「投出去的都怎么样了」用这条，别去翻列表自己数——投稿动辄上百条，翻列表会把上下文占满。念结果用 items 里的 statusLabel（如「已拒稿 × 15」），counts 是给过滤用的原始数值，别把里面的数字念给用户。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleId": { "type": "integer", "minimum": 1 },
+          "mediaId": { "type": "integer", "minimum": 1 },
+          "companyId": { "type": "integer", "minimum": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articleTasks.reuseConfig",
+      "mode": "read",
+      "guide": "article-task",
+      "requiresPlan": false,
+      "description": "把一个已有文章任务的参数读回来，供「照着上次再来一批」用。**只读参数，不建任务、不扣费**。拿到后要先跟用户确认（可以改问题、改篇数、换模型），再走 articleTasks.create。返回里 warnings 说明哪些资源已失效，missingRequiredFields 列出必须重新指定的字段——这两项非空时不要直接拿去 create。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": { "type": "integer", "minimum": 1, "description": "照着哪个任务。id 来自 articleTasks.list" }
+        },
+        "required": ["taskId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "articleTasks.delete",
+      "mode": "write",
+      "guide": "article-task",
+      "requiresPlan": true,
+      "description": "删除文章任务。⚠️ **会连带删掉这个任务生成的全部文章，不可恢复**（数据库级联，不是可选项）。plan 摘要里会给出确切篇数，那个数必须念给用户听——他多半以为只是清掉一条任务记录。还在跑的任务删不了。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": { "type": "integer", "minimum": 1, "description": "要删哪个任务" }
+        },
+        "required": ["taskId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "folders.create",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "新建文章文件夹。建完是空的，文章要另外用 articles.moveFolder 移进来。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "productId": { "type": "integer", "minimum": 1, "description": "建在哪个 GEO 项目下" },
+          "name": { "type": "string", "minLength": 1, "description": "文件夹名" },
+          "parentId": { "type": "integer", "minimum": 1, "description": "建成谁的子文件夹。不传就是顶层。id 来自 folders.list" }
+        },
+        "required": ["productId", "name"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "folders.update",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "重命名文件夹或把它移到别处。parentId 传 null 表示移到顶层。默认文件夹改不了。只动文件夹本身，里面的文章不受影响。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "folderId": { "type": "integer", "minimum": 1, "description": "改哪个" },
+          "name": { "type": "string", "minLength": 1, "description": "新名字" },
+          "parentId": { "type": ["integer", "null"], "minimum": 1, "description": "移到谁下面。传 null = 移到顶层" }
+        },
+        "required": ["folderId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "folders.delete",
+      "mode": "write",
+      "guide": "article",
+      "requiresPlan": true,
+      "description": "删除文件夹。**只能删空的**——里面还有文章或子文件夹会被拒绝，不会连带删除任何内容。要先清空就用 articles.moveFolder 把文章移走。默认文件夹删不了。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "folderId": { "type": "integer", "minimum": 1, "description": "要删哪个" }
+        },
+        "required": ["folderId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationTasks.createArticle",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "建文章发布任务：把已有文章发到自媒体平台。**执行后稿子会真的发出去，CLI 撤不回来**。费用按发布记录条数算——一篇文章发 3 个账号就是 3 条。建之前先用 publicationPlatforms.list（contentType=article）查平台、publicationAccounts.list 查这个公司绑了哪些账号。**文章必须已审核通过且有封面**，两者缺一发不了——用 articles.list 时带上 status 和 mustHaveCover 就只会看到能发的。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string", "minLength": 1, "maxLength": 100, "description": "任务名，给用户认的" },
+          "productId": { "type": "integer", "minimum": 1, "description": "发哪个 GEO 项目的内容" },
+          "aigc": { "type": "boolean", "description": "要不要打「AI 创作」声明。**得问用户**，别替他决定" },
+          "items": {
+            "type": "array",
+            "minItems": 1,
+            "description": "每项是「一篇文章 + 它要发到哪些平台的哪些账号」",
+            "items": {
+              "type": "object",
+              "properties": {
+                "articleId": { "type": "integer", "minimum": 1 },
+                "platforms": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "platform": { "type": "string", "description": "平台标识，填 publicationPlatforms.list 返回的 platform 值" },
+                      "publishAccountIds": {
+                        "type": "array",
+                        "minItems": 1,
+                        "items": { "type": "integer", "minimum": 1 },
+                        "description": "用哪些账号发。一个账号一条发布记录"
+                      },
+                      "publishTime": {
+                        "type": "string",
+                        "description": "定时发布时间，ISO 格式如 2026-09-01T09:00:00+08:00。**不传 = 立即发布**。不能填过去的时间"
+                      }
+                    },
+                    "required": ["platform", "publishAccountIds"],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": ["articleId", "platforms"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["name", "productId", "aigc", "items"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationTasks.createVideo",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "建视频发布任务。和 createArticle 同一套结构，只把 articleId 换成 videoId，平台要用 contentType=video 那批——拿文章平台发视频会被拒。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string", "minLength": 1, "maxLength": 100 },
+          "productId": { "type": "integer", "minimum": 1 },
+          "aigc": { "type": "boolean", "description": "要不要打「AI 创作」声明。**得问用户**" },
+          "items": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "videoId": { "type": "integer", "minimum": 1 },
+                "platforms": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "platform": { "type": "string" },
+                      "publishAccountIds": {
+                        "type": "array",
+                        "minItems": 1,
+                        "items": { "type": "integer", "minimum": 1 }
+                      },
+                      "publishTime": { "type": "string", "description": "ISO 格式。不传 = 立即发布" }
+                    },
+                    "required": ["platform", "publishAccountIds"],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": ["videoId", "platforms"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["name", "productId", "aigc", "items"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationTasks.delete",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "删发布任务。只删任务和它名下**还没发出去**的记录——已经发布成功的稿子留在平台上不受影响，要撤那些得去各平台自己删。一次只能删同一家公司的。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskIds": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "integer", "minimum": 1 },
+            "description": "要删哪些。必须都属于同一家公司"
+          }
+        },
+        "required": ["taskIds"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationTasks.pause",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "暂停发布任务：把它名下**还没发出去**的记录挂起。已经发成功的撤不回来，正在发的那条也拦不住。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": { "taskId": { "type": "integer", "minimum": 1 } },
+        "required": ["taskId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "publicationTasks.resume",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "恢复被暂停的发布任务，挂起的记录重新排队发出去。定时的按原定时间走，时间已经过了的会尽快发。不扣费。",
+      "inputSchema": {
+        "type": "object",
+        "properties": { "taskId": { "type": "integer", "minimum": 1 } },
+        "required": ["taskId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "mediaPublications.create",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "把一篇文章投给一家付费媒体。**文章必须已审核通过且有封面**。**按家收费，单价各不相同**——计划里会逐家列出名字和价格，念给用户听再让他确认。投出去之后发不发由媒体那边定，被拒稿会原路退款。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleId": { "type": "integer", "minimum": 1, "description": "投哪篇" },
+          "mediaId": { "type": "integer", "minimum": 1, "description": "投给哪家。用 mediaPlatforms.list 查在架的媒体和价格" }
+        },
+        "required": ["articleId", "mediaId"],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "mediaPublications.batchCreate",
+      "mode": "write",
+      "guide": "publication",
+      "requiresPlan": true,
+      "description": "把**一篇**文章一次投给多家媒体，最多 20 家。按家收费，计划里逐家列价格和合计。允许部分成功：某家失败不影响别家。执行结果里每家都带 settlementStatus——charged=扣了、not_charged=没扣、refunded=扣了又退回了、refund_pending=扣了但还没退回来（系统会自动补退）。汇总看 netChargedTotal（这次实际净扣多少），**金额单位是元**（结果里的 amountUnit 也写了）。**报账目念这几个数，别自己按成功家数乘单价算**。要重投得重新生成计划。投多篇文章就一篇一篇来。",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "articleId": { "type": "integer", "minimum": 1, "description": "投哪篇。一次只能一篇" },
+          "mediaIds": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 20,
+            "items": { "type": "integer", "minimum": 1 },
+            "description": "投给哪几家"
+          }
+        },
+        "required": ["articleId", "mediaIds"],
+        "additionalProperties": false
+      }
     }
   ]
 }