brandfound.

Command Palette

Search for a command to run...

MCP Server

连接 MCP 服务器

Model Context Protocol 让 AI 助手可以直接与 brandfound. 协作 — 在聊天中管理公司、分析提及并创建内容。每个 MCP 工具都是对 API v1的 HTTP 调用。部分接口针对 MCP 工作流做了优化(Factory 的 context_only、查询的原子化 setup)。

MCP Endpoint

https://app.brandfound.ai/api/mcp/stream

OAuth 2.1 + PKCE

通过浏览器进行安全授权。首次连接时自动创建 API Key。Token 有效期 90 天。可在 设置中撤销访问。

授权
协议OAuth 2.1
PKCES256
传输HTTP
Token
前缀gfx_
TTL90 天
格式Bearer
Discovery
Protected Resource/.well-known/oauth-protected-resource
Authorization Server/.well-known/oauth-authorization-server

选择 AI 助手

点击需要的客户端 — 即可查看连接说明。

可用工具

50

连接后,Connector 会向 LLM 客户端开放这些 brandfound. 功能。客户端会根据任务自行选择合适的工具。

工作空间

2

一个令牌，访问所有可用空间

  • •OAuth 令牌有一个活跃空间，默认是授权登录时的空间。switch_workspace 可切换到邀请状态为 ACCEPTED 的其他空间。
  • •切换结果保存在 ApiKey.activeAccountId，并从下一次请求起对使用该密钥的所有 MCP 客户端生效，包括 Claude Desktop 和 Cursor，无需重新授权。
  • •每次请求都会检查访问权限。若被移出团队，下次工具调用将自动返回令牌原始空间，不会返回401。
  • •切换也会清空 preferredCompanyId，因为它属于旧空间。
  • list_workspaces

    列出个人空间及 TeamMember 状态为 ACCEPTED 的可访问空间，并标记当前空间

  • switch_workspace

    持久切换 API 密钥的活跃空间，并清空 preferredCompanyId

    accountId

公司与产品

7

v1.1：以 upsert 工具代替 create/update 组合

  • •save_company / save_competitor / save_product 合并原 create_* 与 update_*：不传 id 时创建，传 id 时仅更新提交的字段。
  • •更新 synonyms 会完整替换原列表，不会合并；新增同义词时请提交完整数组。
  • list_companies

    列出用户公司，支持搜索与分页

    search, limit, offset, sortBy, sortOrder

  • get_company

    获取公司及其产品详情

    companyId

  • save_company

    创建或更新公司；不传 companyId 时创建。regionTargets 指定检测国家及自动生成查询所用的国家。

    companyId?, name, description, url, country, categoryId, synonyms, regionTargets, defaultLanguageId, defaultResponseLanguageId, defaultLocale, autogenQueryTypes, autogenQueriesPerRun

  • get_company_categories

    公司分类目录：行业与细分领域

  • search_geo

    国家、城市与语言及其 UUID，供 regionTargets 和 defaultLanguageId 使用

    kind, q, countryIso2, limit

  • save_competitor

    创建或更新竞争对手；不传 competitorId 时创建

    competitorId?, companyId, name, productId, url, synonyms

  • save_product

    创建或更新产品，包括重新分配 intents（upsert）

    productId?, companyId, name, description, url, intents

关键词

3

v1.1：通过 action 管理生命周期

  • •manage_keyword 通过 action 合并 create / rename / archive / restore / delete；archive 与 delete 支持 dryRun。
  • •link_keywords 合并按名称关联的 attach（find-or-create）与按 keywordIds 解除关联的 detach，支持 company / product / competitor。
  • list_keywords

    按 target 与状态筛选关键词

    companyId, productId, competitorId, state, search, limit, offset, sortBy, sortOrder

  • manage_keyword

    管理单个关键词：create / rename / archive / restore / delete

    action, keywordId, name, attach, dryRun

  • link_keywords

    批量按名称关联关键词，或按 id 从 target 解除关联

    action, target, names, keywordIds

分析与指标

9

v1.1：合并报告

  • •get_analytics_report 通过 report 选择器代替原六个工具：overview / keywords / timeline / recent / geo / cluster。
  • •get_trends 合并战略主题（scope="topics"，7–30天）与战术信号（scope="pulse"，6–72小时）。
  • get_competitor_analytics

    竞争分析：声量份额与领先品牌

    companyId, productId, timeRange, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode

  • get_brand_visibility

    品牌提及率（BMR）趋势：品牌可见度

    companyId, productId, timeRange, granularity, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode

  • get_tonality

    情感分析：sentiment、fairness、helpfulness 等10余项指标

    companyId, productId, timeRange, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode, queryType, sentiment

  • list_mentions

    筛选 AI 回答中的品牌提及

    companyId, productId, competitorId, sourceIds, timeRange, dateFrom, dateTo, sentiment, type, isOurs, search, sortBy, sortOrder, limit, offset

  • list_queries

    AI 查询、回答与分析

    companyId, productId, hasAnswers, searchText, sourceIds, types, sentiment, dateFrom, dateTo, isFavorite, sortBy, sortOrder, limit, offset

  • get_trends

    趋势：scope="topics"（战略，7–30天）或 scope="pulse"（信号，6–72小时）

    scope, companyId, timeRange, limit, minGrowthPercent, window, signals, minSeverity

  • get_analytics_report

    汇总报告：overview / keywords / timeline / recent / geo / cluster

    report, companyId, timeRange, productId, category, granularity, groupBy, labelId

  • list_query_labels

    查询标签与聚类及其查询数量

    companyId, q, limit, offset, lite

  • list_notifications

    用户通知（WIDGET / BANNER / TOAST / EMAIL）

    limit, offset, type, includeDismissed

查询

7

两种方式：由您的助手编写查询，或由服务自动生成

  • •setup_queries 使用 BYO-LLM：助手根据品牌资料（get_brand_card）和竞争对手（get_company）编写查询。平台不收费，仅需支付您自身 LLM 的令牌费用。
  • •autogenerate_queries 生成草稿，每条查询1 FoxCoin，不采集 AI 回答。approve_query_drafts 才启动付费采集，每份回答10 FoxCoin（查询×模型）。确认前请执行 dryRun 并向用户展示费用估算。
  • •六种类型：neutral、commercial、informational（不含品牌）、comparative（品牌与库中竞争对手）、reputational、branded（含品牌）。兼容旧别名 negative/general。
  • •自动生成的语言与国家来自公司地区设置（save_company.regionTargets）。多国家检测请传 targets，每国一个任务，默认使用官方语言（AE→ar，IN→hi）。
  • •list_answers 每次批量导出最多200份含链接与提及的回答，无需逐条循环查询。
  • setup_queries

    创建助手编写的查询及聚类，可选择启动付费 AI 采集

    companyId, clusters, providers

  • autogenerate_queries

    生成查询草稿，不采集 AI 回答（每条1 FoxCoin）

    companyId, productId, count, types, clusters, userWishes, name, region, language, city, includeDistricts, targets

  • get_autogeneration_status

    生成任务进度：RUNNING / OK / FAILED / CANCELLED

    clientToken, runId, limit

  • list_query_drafts

    等待确认的已生成查询

    status, companyId, type, page, limit

  • approve_query_drafts

    确认草稿并启动所选模型的付费采集；dryRun 仅估算费用

    draftIds, providers, dryRun

  • reject_query_drafts

    免费拒绝草稿，不采集回答

    draftIds

  • list_answers

    批量 AI 回答：链接、提及、brandDomainCited

    companyId, productId, queryId, provider, type, label, region, language, createdAtFrom, createdAtTo, hasLinks, mentionsOurs, include, limit, offset

Factory

13

v1.1：默认 BYO-LLM，仅显式 mode="generate" 收费

  • •enrich_content_task / generate_content_plan / generate_article 默认 mode="context_only"，返回提示词与上下文。客户端 LLM 生成结果并通过 save_* 保存，不扣 FoxCoin。
  • •显式 mode="generate" 与界面一样使用付费服务器生成：补充任务20 FC、大纲50 FC、文章70 FC；余额不足返回402 INSUFFICIENT_FOXCOINS。
  • •suggest_topics 已移除。助手根据补充上下文构思其他角度，并将 topicTitle 传给 generate_content_plan。
  • •manage_content_task 通过 action 合并看板任务的 create / update / archive。
  • list_content_tasks

    筛选内容工厂看板任务

    companyId, statuses, types, priorities, search, tagId, aiGenerated, sortBy, sortOrder, limit, offset

  • get_content_task

    完整任务及已保存文章

    id

  • manage_content_task

    通过 action 创建、更新或归档内容任务

    action, taskId, title, companyId, type, status, priority, description, targetKeywords

  • enrich_content_task

    补充任务：RAG 搜索、分析与竞品研究（context_only 免费；generate20 FC）

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    文章大纲：结构、论点与 tone（context_only 免费；generate50 FC）

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    完整 Markdown 文章（context_only 免费；generate70 FC）

    taskId, planId, articleLength, mode

  • save_enrichment_analysis

    保存客户端 LLM 的分析结果

    taskId, aiAnalysis, usage

  • save_generated_plan

    保存客户端 LLM 的 JSON 内容大纲

    taskId, plan, topicId, topicTitle, prompt, usage

  • save_generated_article

    保存客户端 LLM 的 Markdown 文章

    taskId, content, planId, usage

  • set_publication_url

    设置已发布文章 URL，跟踪 BMR

    taskId, publishedUrl

  • detect_insights

    检测15类洞察：内容空白、竞品优势；基于规则，免费

    companyId, insightType

  • list_content_tags

    内容工厂标签及任务数量

  • list_publications

    已发布内容与效果指标

    companyId

品牌卡

5

助手可读取并维护整套品牌资料

  • •品牌资料是 Markdown 文件树：instruction.md 最先发送给 AI；核心文件 main / settings.md 始终应用；用户可添加产品、事实、案例和 FAQ 等文件或文件夹。
  • •文件通过 [名称](brandcard://<id>) 关联，id 来自索引。重命名不影响链接，关联文件在生成时优先。单次注入上限约60,000字符。
  • •```private 私密块会在发送给 AI 前自动移除。save_brand_card_file 完整覆盖文件，修改前务必先读取当前内容。
  • •建议流程：get_brand_card_index（结构与关联）→ 按所需路径调用 get_brand_card_file → save_brand_card_file。MCP 提示词 manage-brand-card 支持 fill / audit / restructure。
  • get_brand_card

    完整品牌资料 Markdown：清单→核心→关联→其他文件；移除私密块

    companyId

  • get_brand_card_index

    品牌资料索引：清单与文件，含 path、id、isCore 及出站关联

    companyId

  • get_brand_card_file

    按路径读取单个文件：content 保留原始 brandcard:// 链接，links 解析对应路径

    companyId, path

  • save_brand_card_file

    按路径创建或覆盖文件，自动创建缺失目录

    companyId, path, content

  • delete_brand_card_file

    递归删除文件或目录；不可删除受保护的框架文件

    companyId, path