Nooticr

@nooticr/mcp

面向 nooticr 的 MCP（Model Context Protocol）服务。

为 AI 助手提供三种能力：读取十个平台上的真实社交帖子（TikTok、Instagram、YouTube、X、Reddit、LinkedIn、Douyin、Xiaohongshu、Weibo、Bilibili），理解这些帖子——包括转录文本、视频帧、评论和数据——并根据所学内容创作内容：吸睛开场、待拍摄的不同版本、评分后的草稿，以及改编后的串文。

理解由你的模型完成，而不是我们的模型。这里的每个工具都会获取素材，并附上如何处理这些素材的说明；没有任何工具会先向我们的模型征求意见。你只需为素材获取付费，不会产生其他费用。

它还可以监控品牌名称：search_mentions 会在你选择的日期范围内，扫描上述九个平台中提及你品牌的所有评论；search_spoken_mentions 则会识别 TikTok、YouTube 和 Douyin 视频中实际说出口、而非打字写下的品牌提及。

可在本地通过 stdio 运行，也可作为托管连接器使用：https://mcp.nooticr.com/mcp。费用从你的 nooticr 积分中扣除；新账户可获赠 20 个免费积分。

安装（一个链接）

Claude Code — 注册插件市场，然后安装插件：

/plugin marketplace add Nooticr/nooticr-mcp
/plugin install nooticr@nooticr

Claude Code / 不使用插件的 CLI：

claude mcp add nooticr --user -- npx -y @nooticr/mcp
npx @nooticr/mcp login   # one-time sign-in (Google)

Cursor / 任意 stdio MCP 客户端（claude_desktop_config.json、.mcp.json 等）：

{
  "mcpServers": {
    "nooticr": {
      "command": "npx",
      "args": ["-y", "@nooticr/mcp"],
      "env": { "NOOTICR_BASE_URL": "https://api.nooticr.com" }
    }
  }
}

工具

共 169 个工具，按使用目的分组。价格以 nooticr 积分计，并与服务实际收费一致。

回答你真正想问的问题下的任务工具并非端点包装器。每个工具都会明确一项任务，调用完成该任务所需的多个接口，按照你要做的决策对证据进行分组，为每项内容分配一个后续工具可操作的 ID，并将内容交由你的模型解读，而非我们的模型。这些工具会并行调用多个接口，因此费用等于所获取内容的费用总和；每个工具都通过一个参数限制并行调用的数量。

读取帖子

工具	积分	用途
get_social_post	1	帖子的事实信息和媒体内容——contentType、标题、说明文字、作者、统计数据、媒体直链，以及内嵌缩略图。适用于只想查看帖子本身、不需要任何解读的情况。
get_post_transcript	1	实际说出口的内容。如果平台提供字幕轨道（TikTok、Douyin、YouTube），则直接读取原文——准确呈现，不会推断，也不会处理视频；其他平台以及缺少字幕轨道的情况，则会在同一次调用中转录帖子自身的音频（时长不超过 30 分钟），这需要在服务端配置语音转文本功能。没有转录文本则不收费。使用 format: "srt" 或 "vtt"，还会根据字幕轨道自身的时间信息生成可直接使用的字幕文件，不额外收费。当措辞很重要时，请在进行任何分析前使用此工具。
get_post_frames	2	从帖子视频中均匀抽取帧，并以可直接查看的图像形式返回——而非图像描述。ffmpeg 会直接打开视频流，而不是先下载，因此支持 HLS；链接过期时也会即时重新解析。已在 TikTok、YouTube、Instagram、Douyin 和 X 上完成实时验证，成功率为 3/3；Reddit 的视频帖子也可使用。轮播或幻灯片会原样返回自身图像。每帧约占用 1,200 个上下文 token。
get_post_comments	2	热门评论及平台归纳的评论主题，并标明哪些评论被创作者置顶或点赞。适用于查看用户评论内容。

理解帖子

工具	积分	用途
analyze_post_text	2	帖子的转录文本、说明文字和统计数据——除图片外的所有内容。需要获取两次：帖子本身（1，作为 get_social_post）和 get_post_transcript（1）。当文字和数据足以回答问题时使用。
analyze_post	3	从视频中抽取的画面，以模型实际能够查看的图片形式呈现，并附上转录文本。需要获取两次：get_post_frames（2）和 get_post_transcript（1）。当重点在视觉内容——构图、剪辑、屏幕文字时使用。
understand_social_post	3	同样需要获取两次，但要求描述屏幕上实际发生的事情，而不是解释内容为何有效。当你需要了解事件本身，而非策略时使用。
summarize_post_comments	2	评论区中的所有评论（每条评论都有稳定 ID），以及用于标注它们的分类体系——情感倾向，以及每条评论是赞扬、投诉、错误报告、问题、请求、比较还是垃圾内容。调用方式与直接读取评论相同，调用 get_post_comments，价格也相同。传入 verbatim: true 可完整呈现每条内容，便于引用，而不是截断以适应长度；价格不变。
show_comment_review	免费	展示模型生成的分类——每条评论及其情感倾向和类别，可筛选和选择。不发出任何请求；只会呈现你传入的内容。
show_post_analysis	免费	展示模型基于 analyze_post/analyze_post_text/understand_social_post 撰写的分析——钩子强度、脚本结构、可引用语句、建议的话题标签等，涵盖你生成的所有字段。不发出任何请求；只会呈现你传入的内容。
compare_social_posts	1	获取两到五个帖子中的第一个及其统计数据，比较工作由你完成。使用 get_social_post 获取其余帖子，每个花费 1 积分。当帖子表现不同时使用，以了解原因。
show_compared_posts	免费	展示模型基于 compare_social_posts 撰写的比较结果——每个帖子的评分、标记出的赢家、差异，以及值得开展的下一项测试。不发出任何请求；只会呈现你传入的内容。

研究细分领域或创作者

工具	积分	用途
discover_social_posts	2	查看九个网络上某个细分领域的近期帖子，包含内嵌缩略图，并支持通过 limit/offset 分页。用于查找值得关注的帖子。
get_user_posts	2	查看某位创作者的近期帖子及数据。用于浏览某个账号。
search_creators	2	根据创作者的作品寻找人物——设计师、开发者、摄影师以及任何拥有受众的人；可按专业领域、细分领域或关键词查找。适用于知道要找哪类人，但不知道具体姓名的情况。搜索 TikTok、Instagram 和小红书；不搜索 YouTube、抖音、X、Reddit 或 LinkedIn，因为上游服务不支持按创作者搜索这些平台。
get_similar_creators	2	为已验证有效的创作者寻找相似创作者。
suggest_creator_identity	每搜索一个网络 2，另加 2 用于查找账号名（默认共 6）	根据一个已知账号名，寻找同一人在其他网络上的账号，并提供每项匹配依据：两个个人简介都发布了对方链接、一个简介提及了另一个账号、账号名相同，或显示名称相符。只提供建议，绝不合并：不会存储任何信息，由人工确认，也绝不会把两个账号的粉丝数相加。适用于 TikTok、Instagram 和小红书。
discover_sounds	2	查看热门音频及可播放预览。声音是 TikTok 的重要排名信号。
discover_hashtags	2	查看适合使用哪些标签。TikTok 的数据来自创意中心趋势榜，包含热度以及上升／降温／稳定趋势。其他八个可搜索网络的上游没有趋势榜，因此会对你指定的细分领域进行实时扫描并统计标签：数据真实且为最新，但只是单次抽样，所以没有上升／降温信号。source 会说明数据来源。LinkedIn 无法扫描。
find_hook_pattern	2	获取创作者的近期帖子，将开场白作为一组进行阅读，并整理成填空式模板。会调用一次 get_user_posts。
search_mentions	每个网络 2（小红书 5）	**品牌监测。**一次搜索九个网络中每条提及某个词语的评论，并按评论所在的帖子分组。品牌在回复中被提及的次数远多于在说明文字中的次数，因此以评论为单位，而不是帖子。可指定 since 日期查看过去某段时间的数据，并通过 offset/pageSize 分页，避免九个网络的扫描结果一次性全部返回。不会识别视频中的语音内容——search_spoken_mentions 可在 TikTok、YouTube 和抖音上执行此操作。
watch_creator	免费	将创作者添加到关注列表。只存储账号名，不会获取任何内容。
unwatch_creator	免费	将创作者从关注列表中移除。
list_watchlist	免费	查看你关注的对象：账号名、平台、备注、上次查看时间，以及每个账号所属的已保存创作者身份；在 byIdentity 中按人物分组。
save_creator_identity	免费	用户确认不同网络上的账号属于同一人后（例如依据 suggest_creator_identity 提供的证据），将这些账号保存为一个创作者身份：name、accounts（每项为 {platform, handle, evidence?}）、note。只会原样存储所提供的信息；如果账号已属于其他身份，则会拒绝操作并指出该身份，绝不会转移账号。
list_creator_identities	免费	查看工作区保存的所有创作者身份，以及每个身份的账号和对应记录的证据。用于了解 identityId 的来源。
update_creator_identity	免费	重命名已保存的身份、更改或清除其备注，或添加、移除账号。一个身份至少保留一个账号。
delete_creator_identity	免费	删除已保存的身份。只会删除分组，账号及其关注列表条目会保留。
watch_creator_identity	免费	关注某个人，而不是单个账号：已保存身份中的每个账号都会作为独立条目添加到关注列表，各自保留基线，并按身份分组。不会获取任何内容。
unwatch_creator_identity	免费	将已保存身份中的所有账号从关注列表中移除。单独关注的账号会保留。
catch_up_watchlist	每位创作者 2	查看自上次追踪以来所有关注对象发布的内容。会与上次保存的快照比较并更新快照，因此回答的是“新增了什么”，而不是“有哪些内容”。
create_brand_watch	调用免费	安排定期扫描，只通过邮件发送新增内容。kind: "mentions"（默认）会定期对 term/platforms 执行 search_mentions 扫描；kind: "competitor" 会定期检查一位创作者的 get_user_posts（handle/platform），仅当其表现超过自己的近期中位数时才发送邮件；kind: "report" 会按计划运行 job: {tool, args}——niche_report（每次运行都原样通过邮件发送报告）或 discover_social_posts（仅发送未见过的帖子）；kind: "portfolio" 会在同一预算下，跨相同网络扫描最多 25 个 terms（你的品牌、产品、竞争对手），并发送一份汇总，列出每个词语的声量占比。此工具有意设计为两次调用：第一次返回报价（每次运行的费用、频率、每日费用）和 confirmationToken；除非再次调用并传入 confirm: true 及该令牌，否则不会创建或收费。之后每次运行都会按服务端对该项工作的收费计费——提及扫描每个网络 2 个积分（小红书 5 个），竞争对手监测固定 2 个积分；报告运行时，niche_report 为 3 个积分（运行会生成并邮寄报告，而此处的 niche_report 工具会将帖子交给你的模型处理，费用为 2 个积分），discover_social_posts 为 2 个积分（另加每篇打开评论的帖子 1 个积分）；组合监测则按每个词语执行一次提及扫描。预算会平均分配，并减少扫描的网络数量，但不会减少词语数量；扫描失败的词语会退款。appIds 用于将监测关联到工作区的产品（两次调用都要传入）；不传入时，监测范围为整个工作区。
list_brand_watches	免费	查看工作区中的所有品牌监测任务（包括团队成员创建的）：词语、网络、频率、每次运行费用、已用积分、运行次数和下次运行时间。appId 可将列表限定为某个产品的监测任务及工作区级监测任务。竞争对手监测会显示其账号所属的已保存创作者身份；byIdentity 会将同一个人的监测任务归为一组。
creative_assets_list	免费	按最新优先顺序查看工作区中生成的创意素材（配音、音效、音乐、图片、视频、合成作品），包括网址、类型、尺寸或时长及来源。可按 appId、kind、briefId 或 since 筛选，并通过 nextCursor 翻页。
creative_voices_search	免费	按 query、language、accent、gender、age 或 useCase 搜索 ElevenLabs 的语音库。每个结果包含 voiceRef、名称、标签、语言、口音和预览网址。仅提供语音库中的语音，绝不提供克隆语音。
creative_voiceover	首次报价	使用 creative_voices_search 中的语音生成最长 2500 个字符的配音，并提供用于烧录字幕的单词时间信息。首次调用会返回积分报价，不收费；再次调用并传入 confirm: true 和 confirmationToken 即可生成。按实际用量结算，费用不会超过报价。
creative_sfx	首次报价	根据描述生成一段短音效（0.5-10 s）。确认流程与 creative_voiceover 相同：先报价，再确认。
creative_music	首次报价	将时长为 5-60 秒的器乐配乐作为任务生成：确认报价后，轮询 creative_job_status。部署环境可能会关闭此功能；若关闭，工具会说明情况。请描述情绪、节奏和乐器，不要提及艺术家或歌曲。
creative_video	首次报价	根据 prompt 生成一段短视频片段（3-30 s，草稿画质），作为任务生成：确认报价后，轮询 creative_job_status。可选传入 firstFrameAssetId，或最多 3 个 referenceAssetIds（图片素材）；aspect 可设为 9:16 或 16:9，audio 可设为 ambient 或 none。视频会按视频模型支持的最接近时长渲染；报价按该时长计算，调用也按该时长结算。只负责生成，不会编辑上传的视频。
creative_image	首次报价	使用 GPT Image 根据 prompt 生成 1-4 张静态图片（低画质），可指定 size（默认竖版 1024x1536），也可选择 transparent。首次调用会返回积分报价，不收费；再次调用并传入 confirm: true 和 confirmationToken 即可生成。按实际用量结算，费用不会超过报价。返回新的 assets 和 creativeCredits。请勿在提示词中加入大段文字，并要求生成人物而非真实人物。
creative_image_edit	首次报价	使用 prompt 编辑或组合 1-4 个已有图片素材（imageAssetIds），并可选传入 maskAssetId。确认流程与 creative_image 相同：先报价，再确认；返回一个新素材和 creativeCredits。
creative_compose	首次报价	将创意素材（片段、静态图片、配音、音乐、音效）剪辑成一段完整的 9:16、4:5 或 1:1 视频，或一张信息流静态图片：字幕与配音同步，并位于平台安全区域内，采用产品品牌色，配音下方铺设音乐，还可添加片尾卡。最多 12 个片段、60 秒和 6 个音效；设置 draft: true 可生成价格较低的预览版本。采用固定费用进行一次渲染：确认报价后，轮询 creative_job_status。绝不会发布内容。
creative_settings_get	免费	查看工作区的创意支出限额（每日、每月和每次调用上限，是否启用音乐），以及过去 24 小时和本月的支出。此工具只读；所有者或管理员可在控制面板中更改设置。
creative_brief_create	免费	为一个产品提交创意简报（brief、platforms，以及可选的 hook、audience、variants、budgetCredits、slotAt）。你的 Creative Producer 员工会处理队列，团队成员也可在 Creatives 中领取任务。
creative_brief_list	免费	查看创意简报及其草稿、已领取和已交付素材。可按 status（按从旧到新的顺序排列，即队列的处理顺序）或 appId 筛选。
creative_brief_update	免费	更新简报状态（in_progress、awaiting_pick、delivered、failed、canceled），并附加草稿和交付素材；相应 ID 列表会替换简报中原有的列表。由人员在控制面板中选出最终作品。
creative_job_status	免费	根据 jobId 查看异步创意任务的状态：排队中、运行中、已完成、失败或已取消，并查看完成的素材以及报价、扣费和退款的积分。按照 pollAfterSeconds 指定的时间间隔轮询。
sheets_create	免费	在已连接的 Google 账号中创建 Google 电子表格，并创建命名标签页且每个标签页都包含标题行。返回其 ID 和网址；文件由 Nooticr 拥有，因此后续写入无需审批。需要连接该产品的 Google Sheets。
sheets_list	免费	查看连接可访问的电子表格（由 Nooticr 创建或由客户选定），以及每个表格是否可在无需审批的情况下编辑。
sheets_read	免费	读取电子表格的 A1 范围（例如 Ledger!A1:F200）；最多 10000 个单元格。
sheets_append_rows	免费	在标签页末尾追加带类型的行。对于 Nooticr 创建的文件或客户授权你编辑的文件，此操作免费；其他已选定文件需等待审批。
sheets_update_range	免费	使用带类型的值覆盖 A1 范围。审批规则与 sheets_append_rows 相同。
sheets_add_sheet	免费	向电子表格添加一个空标签页。审批规则与 sheets_append_rows 相同。
mention_trend	免费	查看监测任务随时间发现的内容，这是此处其他工具都无法回答的问题——其他所有读取操作都反映当前情况。每次运行记录一个数据点：运行时间、发现的提及数、新增提及数，以及各网络的两项计数，因此可以区分“哪个网络正在增长”和“是热度降了，还是我们停止监测了”。对于竞争对手监测，每个数据点还会记录该次测得的中位数，因此可以把“他们超过了自己的中位数”看作“而且他们的中位数已经翻倍”。另外还会列出被多次运行发现的提及。此工具免费，因为扫描费用已在运行时收取；再次收取查看已付费数据的费用，正是它要解决的问题。
set_brand_watch_alerts	免费	根据 watchId 设置监测结果提醒团队的方式：email（监测任务的邮箱）、slack（工作区在 Nooticr 设置中连接的 Slack），以及 minNew（一次运行至少需要发现多少条新内容才会提醒）。每次运行也会将结果发布到控制面板中该监测任务的讨论串。无需提供邮箱地址或网址，因此帖子中读取的内容无法重定向监测任务。
update_watch_portfolio	免费	根据 watchId 为组合监测任务添加或移除词语。无需重新确认，因为你同意的每次运行预算不会改变——词语增多时预算会被分得更细，回复会列出运行中不再覆盖的网络。
stop_brand_watch	免费	根据 watchId 或 term 停止监测任务。立即生效——不会进行下一次运行，也不会再产生费用。
niche_report	2	查看某个细分领域的近期帖子及其数据，以便分析主流内容形式、开场模式和无人覆盖的空白。会调用一次 discover_social_posts。用于决定创作什么内容。若通过 create_brand_watch 安排为报告任务，每次运行需 3 个积分，因为运行会生成并邮寄报告。
analyze_creator_profile	2	查看创作者的近期帖子及其数据，用于拆解分析：细分领域、主题、开场公式、表现超出或低于预期的内容，以及受众构成。会调用一次 get_user_posts。
get_wikipedia_pageviews	免费	Wikipedia 关注度：使用 Wikimedia 官方页面浏览量数据（已排除机器人流量），查看每天或每月有多少人阅读最多五篇 Wikipedia 文章。提供每篇文章的时间序列、总量、平均值、峰值，以及窗口前后两半期间的变化。统计的是文章读者数，而非搜索量或需求；回复会明确说明这一点。
get_news_volume	免费	查看品牌、竞争对手或话题获得的新闻报道量：统计 GDELT 全球新闻索引在指定时间段内每天的文章数量、每个实体相对于最多两个其他实体的报道占比，以及最新标题。统计的是文章数量，而非读者人数。
get_search_trends	免费	使用 Google 官方 Trends API，在同一 0-100 刻度上比较最多五个词语的 Google Trends 关注度。服务器获得该 API 的访问权限后才会启用（目前为仅限邀请的 alpha）；届时如果无法使用，会返回 not_configured，而不会读取 Trends 网页。
list_watch_mentions	免费	查看存储的品牌监测文本：平台、作者、帖子文字、链接、情绪以及运行发现时间，按最新优先排序，并可按监测任务、日期和文字筛选。免费，因为扫描费用已在运行时收取。
check_disclosure	免费	检查赞助说明是否按创作者所在市场的要求披露合作关系（法国使用 “Publicité” 或 “Collaboration commerciale”，德国使用 “Werbung”，其他地区使用 “#ad”）：显示已披露、缺失或不明确，并列出找到的文字及建议使用的措辞。仅检查说明文字。

回答你真正想问的问题

工具	积分	用途
export_report	免费	一份可粘贴到文档中的报告，根据会话发现的内容生成：帖子、评论和列表均按工具返回的原样呈现为卡片，带有图片、链接和数据，并穿插你自己的分析。返回 Markdown、一份作为嵌入资源的独立 HTML 文档（nooticr://report/<id>），以及结构化结果中的同一份内容。不获取任何内容。
measure_audience_overlap	4 + 每打开一篇帖子 2（默认 16）	衡量同一网络上两个账号是否与相同的人交流：各自近期帖子下的评论者、同时出现在两边的评论者，以及两个方向的重合情况（已经在你这里评论过的对方评论者，与在对方那里评论过的你的评论者，是两个不同的数字）。统计少数几篇帖子下的活跃评论者，而不是关注者，并会明确说明这一点。postsPerCreator 决定费用。
answer_my_audience	2 + 每打开一篇帖子 2（默认 14）	search_mentions 的镜像工具。 等待你在自己的帖子下回答的问题：获取近期帖子，读取每篇帖子下的评论，按评论所属帖子分组，为每条评论提供稳定 ID，并标记看起来像问题或请求的评论，将其排在前面。它负责查找并起草回复，但不能自行发布：草稿可供人复制粘贴，也可在确认文本后通过 draft_comment_reply 和 post_comment_reply 发送。limit 限制打开的帖子数量，也决定费用。
prepare_handoff	免费	交接给你的跟踪工具。 将你归类的内容——评论中的错误报告、视频中口述的投诉——转换为 title、body 和 labels，以便通过宿主同时连接的任意 GitHub、Jira 或 Linear MCP 服务提交。nooticr 不会提交任何内容，也不保存跟踪工具凭据。正文会将引文放在代码围栏中，并注明这是第三方报告，而不是指令，因为接下来读取问题的是编码 Agent；联系信息会被隐去，@handles 和 #numbers 会被处理为无效形式，以免提交时意外通知任何人；此外还会提供 searchFirst 字符串，用于将第二轮搜索与第一轮去重。不发送任何请求。
list_comments_to_answer	免费	你已连接的自有账号下尚无人回复的近期评论，按时间从新到旧排列（YouTube 在使用 capabilities: ["manage_comments"] 连接后可用；其他网络会在 unsupported 下返回原因）。只读。
draft_comment_reply	提供 text 时免费，nooticr 每写一条回复计 1 次	保存对一条评论的回复草稿；不会发布任何内容。已写好的回复会遵循工作区的品牌语气（有多个产品时，appId 用于选择产品），并附上 rationale；如果没有可供参考的品牌语气、产品或 guidance，则会拒绝撰写且不收费。返回 draftId 和 confirmationToken，供你先展示给用户。commentIds 可一次为同一账号的最多 10 条评论起草已写好的回复，每条回复都有各自的 draftId 和令牌，并列出跳过的评论及原因。
post_comment_reply	免费	以你自己的账号发布已保存的草稿。需要提供 draftId、confirm: true 和 confirmationToken，且必须在用户同意确切文本之后才能发布。每条评论最多回复一次。
show_audience_replies	免费	按帖子分组展示你的回复草稿，供人逐一处理，并附上你决定如何处理每条评论。不会发送或获取任何内容。
show_standings	免费	绘制你的模型从 compare_creators 或 watchlist_standings 读取的排名——每位创作者一行，并标出统计窗口及用于评分的中位数。ranking 记录排序依据，tooThin 会将统计窗口过短的创作者标记为未排名，而不是排在最后：未参与比较不等于输了比较。不发送任何请求。
show_trend	免费	绘制你的模型从 mention_trend 读取的趋势。tooShort 会标记点数太少、无法判断趋势方向的序列；edgeIsRecordStart 会标记左边缘是记录起点，而非对话起点——如果图表隐藏了其中任一信息，就可能替你得出错误结论。不发送任何请求。
track_creator	2	创作者发布了什么，以及其中哪些内容的表现超过了他们自己的中位数，而不是主要反映关注者数量的原始浏览量。返回一个帖子列表，统计窗口不限。如果该创作者在你的监控名单中，还会标记上次检查以来的新内容并更新该标记——这是它自己的标记，不是 catch_up_watchlist 使用的标记。
compare_creators	每位创作者 2（4-10）	将 2 到 5 位创作者并排比较，使用唯一可比的指标：每篇帖子相对于该创作者自身中位数的比率。每位创作者会提供评分所用的统计窗口、中位数、超过该中位数的帖子比例、超过时的幅度、每个比率，以及表现最好和最差的帖子。它不会给创作者排名——“他们多常发布表现出色的内容”和“表现出色时成绩有多好”通常并不一致，而短统计窗口的命中率可能仅取决于一篇帖子，因此每个数字都会附带统计窗口，如何解读由你决定。
watchlist_standings	每位受监控创作者 2	对监控名单中的所有人进行同样的比较：一次调用就能知道“谁有变化”，而不必为每位创作者分别调用。读取监控名单免费；获取数据不免费，因此会在扣费前确认总费用。catch_up_watchlist 回答有哪些新内容；此工具回答表现如何。
find_collaborators	2，提供种子创作者时为 4	协作候选名单：将关键词搜索结果与符合条件的创作者相似账号合并，并标明每个候选是通过哪种搜索找到的。每位候选还会附带从其个人简介中提取的链接，按打开后能提供的信息量分类并排序——例如可供阅读代码的代码库、其个人网站、包含实际链接的链接聚合页——这样审核时可以查看实际作品，而不是再次查看关注者数量。此处不会获取这些链接：它们来自受评估者本人控制的字段，因此由宿主打开，结果中也会说明这一点。它不会衡量受众重合度——每位候选大约要花 8 个积分，因此结果会说明这一点，并建议对入围者使用 measure_audience_overlap，而不是伪造这一指标。
find_people_with_problem	每个平台 6	找出用自己的话描述问题的人——潜在客户、早期用户，以及任何遇到你的产品能够解决的问题的人。用普通人会采用的说法描述问题，它就会搜索形式类似于该投诉的帖子，而不是搜索相关主题：搜索主题会找到相关营销内容，而这正是 discover_social_posts 的用途。它会将查询扩展为投诉常见的表达形式——直接陈述、询问“还有其他人遇到这个问题吗”，以及询问“有没有解决这个问题的工具”——并标明每篇帖子是由哪种表达形式检索到的。这是宽泛搜索，不是筛选器：搜索结果会返回给你自行判断，其中很多可能不相关。默认搜索 Reddit，因为人们常在这里用完整句子描述工作流中的痛点。每个平台会针对每种查询形式搜索一次——默认三种，每次搜索 2 个积分。此处无法搜索 LinkedIn，因为上游服务不提供关键词帖子搜索。传入 verbatim: true 可让每条内容完整显示，便于引用，而不是截断以适应长度；费用相同。
show_collab_shortlist	免费	展示你评分和排名的候选对象，并询问用户想联系谁。评分会注明由你的模型给出，而不会被呈现为 nooticr 的评级；如果某位候选人的评分是在尚未打开任何内容的情况下得出的，则会标记为未经验证。不发送任何请求。
benchmark_post	3	将一篇帖子与创作者近期的数据分布进行比较，并将该帖子从自身基准数据中排除。返回中位数、四分位数、比率和百分位数，因此可以得出“这是正常表现，不是失败”这样的结论。这与 compare_social_posts 要回答的问题不同，后者会比较你已选定的两个 URL。
content_ideas_from_audience	2 + 每读取一篇帖子 2 + 2（默认 12）	对照需求与供给：将评论者明确提出的需求，与细分领域搜索显示的现有内容并列呈现。无人提出的空白需求只是噪声；无人满足的请求才是机会。如果你未指定细分领域，则使用你最常用的主题标签。
detect_spoken_mentions	2	识别一段视频中所有被口头提及的品牌。 并列提供口述转录和文字说明，供你的模型逐一列出品牌，并附上原话句子、创作者的表达语境，以及品牌是以口述、文字还是两种形式出现。即使创作者从未启用字幕也能使用，因为它会转录音频。get_post_transcript 收费 1 个积分，get_social_post 收费 1 个积分；无法生成转录时不收费。
search_spoken_mentions	按细分领域缩小范围后，每个平台 2 + 每个创作者账号名 2 + 每份转录 1，最多 maxTranscripts 份	search_mentions 的镜像工具，用于查找口头提及而非文字提及。 先缩小候选帖子的范围（细分领域搜索、指定账号名和／或你的监控名单），再对观看量最高的帖子转录，最多不超过硬性上限，并在转录文本中搜索指定词语——适用于 TikTok、YouTube 和 Douyin，且仅限创作者实际启用了字幕的内容。会报告找到、转录和匹配的候选数量，让费用清晰可见。

研究 Amazon 市场

以上内容都在解读社交内容。下面这些内容解读的是电商平台市场——同一群受众会在这里说出他们实际买了什么，以及为什么退货。这些内容旨在帮助做出品类决策：我们正在考虑南非醉茄——人们为什么购买、什么因素会让他们却步、现有产品擅长什么，以及市场缺口在哪里？ 所有这些答案都藏在评论文本中，因此工作重点是扫描整个品类，而不是查询单个产品。

采集确实很慢，而且确实如此：每个商品详情页都需要在 Amazon 的机器人防护机制后进行真实的浏览器渲染，而页面之间的访问速度取决于 Amazon 的容许程度，而不是机器的处理能力。采集十个商品详情页及其评论需要几分钟，而非几秒——因此，扫描会先返回已准备好的结果，并为其余内容返回一个 scanId。

工具	积分	用途
scan_amazon_category	每收集一个商品列表 3 积分（默认 30 个）	收集该品类的商品列表：包括价格、星级分布图、Amazon 自身的评论维度计数和评论正文，以及对这些数据的计算结果——价格分布、评分分布、哪些维度在多少个品牌中反复出现，以及各商品列表中 1–2 星评分所占比例（该比例根据星级分布图读取，而非根据抓取返回的少量评论计算）。传入 query 可搜索品类，传入 asins 可指定客户提到的竞争对手，也可以同时传入两者；指定的竞争对手会排在最前面。由于价格由参数设定，工具会在扣费前确认总额。
amazon_scan_status	免费	通过 scanId 继续获取正在进行的采集结果——包括自上次以来收集的商品列表及相同的汇总数据。免费：这是 scan_amazon_category 要求进行的轮询；对同一答案的后半部分收费，就等于对服务端自行决定的等待时间收费。
get_amazon_product	3 积分	按 ASIN 或 URL 获取一个商品列表：价格、评分、完整星级分布图、特征、规格、Amazon 的评论摘要和维度细分，以及评论。
scan_marketplace_category	每收集一个商品 3 积分（默认 30 个）	在另外十一个网站上查看同一品类：AliExpress、Cdiscount、Flipkart、Mercado Libre、Lazada、Otto、Rakuten、Trendyol、Jumia、Vinted 和 Temu。Vinted 是二手交易平台，而非零售平台，因此其 rating 描述的是卖家；扫描结果会在 ratingScope 中说明这一点——不要将其解读为商品评论评分。marketplace 用于选择网站；对于有多个店面的站点，market 用于选择店面。参数名称会按各站点实际支持的选项提供，因此模型无法把 Lazada 的地区发送给 Otto。汇总方式相同，扣费前也会进行相同的确认。
marketplace_scan_status	免费	通过 scanId 和相同的 marketplace 继续获取正在进行的 Marketplace 采集结果。免费，原因与 amazon_scan_status 相同。
get_price_history	免费	查看某个商品随时间变化的 price，或通过 metric 查看其 rating、reviewCount 或 availability；数据来自每次扫描时存储的观测结果。marketplace 和 id 的命名方式与 get_marketplace_product 相同；from/to 默认表示最近 30 天。返回的时间点按从旧到新排列，并提供最小值、最大值、首个值、最后一个值，以及从首个值到最后一个值的变化。仅读取已存储的数据；从未扫描过的商品会返回 recorded: false。
marketplace_changes	免费	查看自上次扫描相同 marketplace 和 query 后，品类中发生的变化：进入或离开搜索结果的商品，以及价格或排名发生变化的商品。根据最近两次已存储的扫描结果读取，不会获取任何新数据；如果某个品类只扫描过一次，则会说明没有更早的扫描记录。
track_price	免费	在工作区的价格历史页面跟踪已在此处读取过的商品列表（使用 marketplace 和 id，命名方式与 get_marketplace_product 相同）。competitorOf 用于将其与工作区自有的一个跟踪商品列表进行对比；productLine 用于将商品列表分组。再次跟踪时，只会更改已提供的字段。不会获取任何数据，因此从未读取过的商品会被拒绝，并提示先读取以记录数据。
untrack_price	免费	停止跟踪某个商品列表。如果工作区自己的扫描结果中仍包含该商品列表，它会继续显示在页面上，并标记为扫描中看到的结果；如果它此前仅被跟踪，则会从页面中移除。未被跟踪的商品列表不会进行任何操作。
get_marketplace_product	3 积分	按 ID 或 URL 从十二个网站中的任意一个获取一个商品：价格、评分、完整星级分布图、规格和评论。
show_amazon_category_insights	免费	将你的模型撰写的分析——购买驱动因素、购买障碍、各品牌的优势、市场空白和定位角度——与商品列表及其评论并列展示，以便用户点击商品，并根据相关文本核实任何结论。结论会注明由你的模型得出，绝不会被呈现为对任何商品的 nooticr 评分。提供 scanId 时，会从扫描本身重新读取商品列表（免费），而不是展示模型重新发送的内容，并标记分析中提到但扫描未包含的任何 ASIN；未提供 scanId 时，卡片会注明其中的商品列表未经核验。
show_marketplace_category_insights	免费	为其他十一个 Marketplace 展示相同的卡片：将你对该网站的分析与其商品列表及评论并列展示，标明正确的网站，并通过 scanId 和 marketplace 从扫描结果中重新读取，避免重新输入任何内容。

创作内容

工具	积分	用途
generate_hook_ideas	2，或免费	提供源帖及其转录文本，用来撰写开场白。若提供主题而非 URL，则不会抓取任何内容，也不花费积分。
show_hooks	免费	展示模型通过 generate_hook_ideas 撰写的开场白——每条都附有使用的技巧及其针对的对象。不会发起任何请求；只会呈现你传入的内容。
evaluate_social_draft	免费	返回你的草稿，并附上用于评估的评分标准——开场白、清晰度、回报、具体性和契合度，每项评分为 1-10 分；此外还会列出值得进行的三项修改，并重写开场白。不会抓取任何内容：文本本来就是你的。这是唯一一个在内容创作完成前运行的工具。
adapt_post_for_platform	2	提供源帖及其转录文本，用于改写成适合其他平台的内容——X 帖子串、LinkedIn 帖子、轮播幻灯片、YouTube 元数据、电子报。
show_repurposed_post	免费	展示模型通过 adapt_post_for_platform 生成的改写文案——每个平台一条。不会发起任何请求；只会呈现你传入的内容。
generate_post_variants	2	提供表现良好的帖子及其转录文本，用来创建不同版本：开场白、变化后的角度、按顺序排列的镜头节拍和行动号召。
show_variants	免费	展示模型通过 generate_post_variants 撰写的不同版本——每个版本都包含开场白、角度、节拍和行动号召。不会发起任何请求；只会呈现你传入的内容。

账号

工具	积分	用途
nooticr_getting_started	免费	查看此账户的当前状况——余额、已连接的账户、关注列表——以及建议的后续调用，每项都附有价格和示例。服务端的 instructions 会引导每个宿主使用它。
check_nooticr_credits	免费	查看余额和账单网址。
nooticr_settings_read	免费	查看默认社交平台和结果数量。
nooticr_settings_update	免费	保存默认平台和结果数量；调用受支持的搜索时，若省略参数，就会使用这些默认值。
list_tool_runs	免费	查看工具调用历史：运行了什么、是否成功，以及每次调用实际消耗的积分（免费、已退款、缓存或重放的调用消耗为 0）。scope: "workspace" 会向所有者和管理员显示每位成员的运行记录。
get_tool_run	免费	按 ID 查看历史中的一条运行记录，以及完整错误信息。
get_usage_report	免费	汇总某个时间段内的运行记录：调用总数、失败次数和实际消耗的积分，并按工具和日期列出，另附最近的失败记录。scope: "workspace" 会为所有者和管理员增加每个席位的一行记录。
nooticr_login	免费	调用因身份验证错误而失败时，重新关联账户。
list_social_connections	免费	查看已连接的账户，以及每个连接实际获准执行的操作——读取账户、发布帖子、管理评论——并以是、否或未知表示。“发布”是 AI 员工发布帖子所需的授权：此处没有任何工具会发布帖子。只有在 Nooticr 仪表板的收件箱中批准该员工的 schedule_post 操作，或者为该员工开启发布自动驾驶后，帖子才会发布。“管理评论”显示平台授予的权限；此工具不会发布任何内容；只有在用户确认草稿后，通过 post_comment_reply 才会发布回复。未知表示该授权早于权限范围记录；应将其视为“尝试”，而非拒绝。此工具还会说明哪些平台可以连接；可连接的平台范围比 nooticr 能读取的网络更小。
connect_social_account	免费	生成一个供用户打开的链接，用于连接一个账户。用户在自己的浏览器中向服务提供商授权；在此之前不会连接任何账户，也不会有凭据经过此工具或模型的上下文。每次调用都会生成一个新链接；旧链接不能重复使用。对于 YouTube，capabilities: ["manage_comments"] 也会申请 list_comments_to_answer 和 post_comment_reply 所需的权限。
hire_employee	免费调用	雇用一名按计划在工作区内工作的 AI 员工（例如社交媒体经理）。按设计需要调用两次：第一次不会创建任何内容，而是返回报价和 confirmationToken；只有在你表示同意后，才使用该令牌再次调用并设置 confirm: true。订阅式雇用（由 level 和 currency 选择套餐）还会提供 hireId：确认时必须原样传回，因为令牌与它绑定。除非启用了自动驾驶，否则公开操作须经你批准。运行费用由雇用者承担，最高不超过月度预算。
list_employees	免费	查看你的 AI 员工及其状态、计划、下次运行时间和剩余预算；设置 includeFired: true 可包含已解雇的员工。
pause_employee	免费	暂停 AI 员工（其记忆和对话线程会保留），或使用 resume: true 恢复。只有雇用该员工的人或工作区管理员可以操作。
fire_employee	免费	永久解雇 AI 员工：停止运行，并丢弃等待批准的操作。第一次调用只会说明将发生什么；使用 confirm: true 确认。
list_teams	免费	查看你的 AI 员工团队：状态（以及暂停原因）、成员、待批准事项、未完成的交接任务和已使用的包含工作量占比。了解 teamId 的来源。
get_team_status	免费	查看一个团队的详细信息：成员的级别、状态和付款状态、本周计划、工作简报的版本及其缺少的内容，以及你是否可以修改。
list_team_templates	免费	查看工作区可以组建的团队：其角色、每个团队能否立即启动及所需条件，以及各级别的月费。提供 goal 后，还会显示“为我组建团队”页面针对该目标建议的团队。不会雇用任何人。
get_team_draft	免费	查看你的团队草稿，即“为我组建团队”页面正在编辑的同一份草稿：已填写的答案、当前步骤、启动还需要什么、页面链接以及当前价格。
update_team_draft	免费	将答案、所选团队或步骤保存到该草稿中（JSON 合并补丁）。不会启动团队或收费。
hire_team	免费调用	启动一个团队。按设计需要调用两次：第一次返回报价（成员、级别、价格、总价、需要等待批准的事项）和 confirmationToken；确认后的调用会创建等待付款的团队，你需要在 Nooticr 仪表板的“团队”页面完成付款。在此之前，任何人都不会开始工作。
update_team_brief	免费	修改团队工作的依据：补丁会保存为工作简报的下一个版本，回复会说明由哪位成员在何时接手。
pause_team	免费	暂停团队（其运行会停止，但订阅不会停止），或恢复已暂停的团队。
fire_team	免费	解散一个团队。第一次调用只会说明将发生什么；使用 confirm: true 确认。不会退款。
crm_upsert_creator	免费	将创作者添加到你的创作者管道，或更新已有创作者（按 platform + handle 匹配）。只会更改你传入的字段；新创作者的状态为 prospect。引用的每个数字都应写入 evidence。
crm_list_creators	免费	查看你的创作者管道，按最近更新时间从新到旧排列，并显示每位创作者最近一次互动。可按 status、appId、query 或 dueBefore 筛选。
crm_update_status	免费	将创作者移至新的管道状态并记录原因。除非由人员更改，否则 do_not_contact 状态会保留；AI 员工只能使用 prospect、shortlisted 或 paused。
crm_log_interaction	免费	为创作者记录备注、审核结果、外联草稿、回复或交付内容。AI 员工不能记录 outreach_sent。
list_pending_actions	免费	查看 AI 员工等待你批准的事项，每项都附有将要发布、发送或更改内容的预览。可选指定一个 employeeId。
get_employee_audit	免费	查看一名 AI 员工的审计记录，按时间从新到旧排列：运行记录、模型调用及其费用、工具调用（参数已隐藏）、读取的来源、包含审批者修改内容的审批记录、已执行的操作及其外部 ID、配置更改、暂停和错误。可按 from/to、types、runId 或 actionId 筛选；设置 verify: true 可重新检查防篡改哈希链。仅限工作区所有者和管理员使用。
approve_action	免费	按 actionId 批准一项待处理操作。第一次调用会返回预览和 confirmationToken，不会运行任何内容；你确认后，已存储的操作会恰好运行一次。
reject_action	免费	拒绝一项待处理操作，可附加备注供员工参考。
connect_store	免费	生成一个链接，供工作区所有者或管理员打开，以连接 Amazon 卖家账户、Shopify 商店或 WooCommerce 商店。用户在商店端授权；在此之前不会连接任何账户，也不会有凭据经过此工具。PrestaShop 商店通过密钥连接，因此只能在仪表板的“设置”中连接，不能通过聊天连接。
list_store_products	免费	读取已连接商店自己的商品目录（Amazon、Shopify、WooCommerce 或 PrestaShop）：标题、描述、状态、价格和 Amazon 商品信息问题。只读。
get_sales_and_traffic	免费	查看已连接的 Amazon 商店最多 90 个完整日期的销售和流量报告：会话数、页面浏览量、转化率（每单位会话百分比）、Buy Box 份额、商品数量和销售额，并提供总计、每日和每个商品的数据。Amazon 会生成报告，因此首次调用可能返回 in_progress，提示你一分钟后再次调用。
get_account_health	免费	查看 Amazon 卖家账户的健康评级，以及各项绩效指标（订单缺陷、延迟发货、取消、有效跟踪）与 Amazon 自身目标的对比，并指出未达标项。
get_fba_inventory	免费	查看按 SKU 列出的 FBA 库存：可配送、入库中、预留、无法配送和总件数。只读。
list_connected_reviews	免费	查看你通过自己的账户连接的评价平台上关于你业务的评价（Trustpilot、Judge.me、Yotpo、Okendo、Google Business Profile），包括星级分布、平均评分和 1-2 星评价占比。对于尚未连接的平台，工具会返回 not_connected。
draft_review_reply	免费	为一条 Trustpilot 或 Google Business Profile 评价保存一条公开回复，供你批准；回复保护规则会先运行（不得包含链接、联系方式或书面政策中未提及的补救措施）。返回 draftId 和 confirmationToken。不会发布任何内容。
discord_list_channels	免费	查看你已连接的 Discord 服务端中的文字频道。
discord_read_messages	免费	查看该服务端一个频道中的最新消息，按时间从新到旧排列。如果机器人没有 Discord 消息内容访问权限，工具会明确说明该频道无法读取，而不会保持沉默。
draft_discord_reply	免费	为一条 Discord 消息保存一条回复，供你批准。返回 draftId 和 confirmationToken。不会发布任何内容。
post_drafted_reply	免费	在你同意回复的确切文本后，以商家身份公开发布已保存的评价或 Discord 回复：传入 draftId、confirm: true 和 confirmationToken。每条评价或消息只会回复一次。
create_product	免费	在你自己的工作区中创建商品——所有其他自有账户工具都需要先有这条记录，才能开展工作。始终在调用会话所属的工作区中创建，绝不会创建到你指定的其他工作区。必须提供 name 和 slug；其他字段均使用 snake_case，并按完全匹配的键读取，因此 camelCase 的 websiteUrl 不会写入任何字段。不会写入品牌手册。
update_product	免费	更新商品字段。省略某个参数会保留其列的原值，因此不能通过不提及某个字段来清空它；结果会列出实际写入的内容——拼错的字段会显示为未更改，而不是被静默忽略。

你自己的产品

以上内容都是读取他人的内容。以下内容则是读取并生成你自己的内容——使用不同的产品、不同的额度（你工作区套餐中的 AI 额度，而不是上述个人 MCP 额度），计费方式与对应的仪表板按钮完全相同。

工具	积分	用途
list_own_apps	免费	工作区中的所有产品——如果有多个产品，且下方的其他工具要求提供 appId，请先调用此工具。
create_product	免费	在工作区中创建新产品——必须提供 name/slug，还可选择提供 description、website_url、niche、product_type 和商店列表字段（使用 snake_case——见下方说明）。无需提供工作区 ID；始终在你自己的工作区中创建。不会生成品牌手册——如需生成，请调用 analyze_product。
update_product	免费	更新产品字段——省略的参数不会更改对应列。字段名称与 create_product 中相同，均使用 snake_case。
get_scheduled_posts	免费	内容工作流中你自己的定时发布和草稿帖子——标题、状态、定时时间、审批状态。查看排队待发布的内容。
get_post_performance	免费	你自己已发布帖子的互动数据——浏览量、点赞数、评论数、分享数、收藏数、展示次数、格式、平台、发布日期，以及 engagementPerView，即（点赞数 + 评论数 + 分享数 + 收藏数）÷ 浏览量；排名应依据此比率，而非原始浏览量。不包含触达人数、观看时长或粉丝数。搭配 growth_brief 获取解读。
get_video_stats	免费	你所有已连接创作者最近同步的视频表现数据——浏览量、点赞数、评论数、分享数，以及累计总数。读取上次同步的数据；不会触发新的同步。
get_google_analytics_data	免费	你的产品在 GA4 中的数据，截至上次同步到 nooticr 时；不是实时数据：属性、日期范围、已同步的行数、会话数、用户数、关键事件和各默认渠道组的收入，以及约 13 个月内每周的会话数和关键事件数。
get_search_console_data	免费	截至上次同步时的 Search Console 数据：网站在该时间范围内的点击次数、展示次数、点击率和平均排名（网站总计，并非查询行之和）、最多 50 条查询及各自的数据，以及约 16 个月内每周的点击次数和展示次数。同步无法读取的数据不会显示，绝不会显示为零。
get_search_performance	免费	你的产品在 Google Search 中的网站数据，来自已连接的 Search Console，实时获取：按查询、网页、国家/地区、设备或日期查看点击次数、展示次数、点击率和排名，并支持 filters 和 compare_to_previous。参数使用 snake_case，必须提供 app_id。当已连接的账号有权访问同一网站的其他 Search Console 属性时，site 可读取该属性（例如与网址前缀属性并存的网域属性）；它也适用于 inspect_url 和 get_sitemaps。
inspect_url	免费	检查 Google 是否已收录你自己网站中的网页：判定结果、覆盖范围、Google 选择的规范网址与你的规范网址、上次抓取时间、robots 和抓取状态。仅限已连接网站上的网址；每次调用最多 20 个网址，每次 Agent 运行最多 20 个网址（每个网址都会占用网站自己的每日检查配额）。
get_sitemaps	免费	查看已为你自己的网站提交的站点地图，包括已提交和已收录数量、错误和警告；使用 url 可查看某个站点地图的详情。只读：无法提交站点地图。
get_page_speed	免费	查看你自己网站某个网页的 Core Web Vitals：有足够数据时显示真实用户字段数据（LCP、INP、CLS），并提供实验室评分和最主要的优化空间。strategy 可设为 mobile（默认）或 desktop。
get_posthog_analytics	免费	查看你的 PostHog 页面浏览趋势，截至上次同步时的数据——将帖子日期与网站流量对应起来。
list_app_reviews	免费	查看每日同步保存的你应用在 App Store 和 Google Play 上的评论：星级、文本、地区、应用版本及你是否已回复，并显示星级分布和商店本身显示的评分。
get_tracked_conversions	免费	按营销活动、来源或媒介查看你自己的网站或应用发送给 Nooticr 的 UTM 标记事件计数（链接点击、注册、购买、安装），时间范围最多 90 天。仅提供计数，不包含任何个人数据。
get_content_plan	免费	获取产品已保存的每周内容计划（如果已生成）。如果没有计划，则 plan: null。
get_brand_playbook	免费	获取你产品的品牌手册——名称、描述和手册文本——如果已在控制面板中或通过 analyze_product 配置。只读；如果不存在，则 available: false。
review_post	免费	发布前为草稿评分——开场吸引力、A/B 开场对比、视觉效果和叙事建议，以及改写后的开场和文案。绝不收费，与控制面板自带的发布前审阅功能相同。
draft_post	计划 AI 积分	为某个主题生成可直接使用的草稿（标题、文案、话题标签、逐页脚本），内容以你产品的名称为依据。仅返回文本——不会保存任何内容。
growth_brief	计划 AI 积分	以通俗语言撰写简报——最重要的洞察、成效、风险和后续行动，并以你真实的帖子历史和已同步的分析数据为依据。
generate_content_plan	计划 AI 积分	为你的创作者生成一周的逐日内容计划，并以已有成效为依据。计划会保存，可稍后通过 get_content_plan 获取。
generate_captions	计划 AI 积分	为视频生成带时间点的屏幕字幕提示——包括文字稿以及标注起止时间的字幕行。仅返回提示数据。
analyze_product	计划 AI 积分	开始对你的产品进行 AI 分析：抓取其网站摘录（会实际向外部网站发起请求，而非仅使用 nooticr 自身数据），读取帖子和所有创作者的表现数据，并将结果写入品牌手册。任务在后台运行——返回 jobId，可通过 analyze_product_status 轮询。消耗 10 个计划 AI 积分；每个工作区首次分析免费。
analyze_product_status	免费	轮询由 analyze_product 启动的任务。返回 state（pending/thinking/done/error），完成后还会返回分析结果。免费——费用已在任务启动时扣除。
list_social_connections	免费	查看你已连接的社交账号及各账号获准执行的操作——读取、发布、管理评论。发布操作通过 AI 员工完成：你在控制面板中批准其帖子后发布；如果为该员工启用了自动发布，则会自动发布；无法通过此工具发布。还会列出可以连接的平台。
connect_social_account	免费	获取用于打开并连接账号的链接。你需要在服务提供商处批准；在你批准之前不会建立连接，任何凭据都不会经过此工具。capabilities: ["manage_comments"] 用于请求 YouTube 的评论管理授权。

计费方式

• 新账户可获得 20 个免费额度。
• 每个工具的定价都与其上游获取数据的费用相同，并从首次调用起计费。一个工具如果会发起两次获取，就会按两次收费——analyze_post 获取画面帧收费 2 个额度，获取转录文本收费 1 个额度，工具描述中也会说明这一点。首次使用不免费：免费额度原本用于 AI 调用，而这里没有 AI 调用。
• 调用失败会自动退款，调用在执行过程中中断时最多只计费一次——重试具有幂等性。
• 平台管理员不会被扣除额度。

Claude / ChatGPT 聊天中的交互式卡片

每个会返回帖子的工具也会在聊天中直接呈现内嵌交互式卡片（MCP Apps 的 ui://nooticr/view 资源通过沙盒 iframe 呈现）：

• 视频帖子（TikTok/IG/YouTube/Douyin/LinkedIn）——内嵌 <video> 播放器，以缩略图作为封面，播放重新托管的永久 MP4（没有会过期的 CDN 令牌）。
• 轮播 / 幻灯片——可水平滚动浏览每张幻灯片，并显示图片数量标签。
• 单张图片——内嵌缩略图。
• 纯文本帖子（LinkedIn / X）——以样式化的引用块呈现帖子文本。
• 官方品牌标志——每张卡片都会显示平台的真实徽标（simple-icons），并使用品牌颜色，而非表情符号。

search_mentions 会呈现不同的视图，因为监控的目的是分类处理，而非浏览：

• **每一行都代表一个正在发言的人。**先显示他们的头像，并叠加所属网络的标志；然后显示用户名和发帖时间——例如“今天下午 7:25”，而非时间戳；接着显示评论，并高亮其中每一处匹配的词语；最后显示获得的点赞和回复数。×N 标签表示评论中多次提到该品牌。
• **每篇帖子都显示其传播范围。**一条评论出现在获得 25K 赞的帖子下，与出现在无人看到的帖子下，是两种不同的问题，而屏幕上没有其他信息能告诉你正在查看的是哪一种。
• **各网络的数量可用作筛选器。**点击某个网络即可筛选；没有返回内容的网络仍会显示，但无法点击，因为筛选到该网络没有意义。筛选和排序会基于已付费获取的数据重新绘制视图——不会重新查询。
• **集中出现的评论会折叠显示。**如果一篇帖子下连续出现多条近乎相同的回复（例如有组织的粉丝活动），视图会显示前几条，并提供其余内容，避免它们把其他四个网络的内容挤出屏幕。
• **评论可以选择，选择结果可供 Agent 使用。**勾选任意评论，或一次性选中整个讨论串，然后发送——视图会将工具发放的评论 ID 交给宿主，因此模型可以针对所选评论进行回复、升级处理或分析。筛选和排序后，已选内容仍会保留。
• 加载更多会从工具返回的 nextOffset 开始分页。

此外，面向模型 / 纯文本客户端也会呈现内嵌缩略图：

• get_social_post / understand_social_post / analyze_post——最多内嵌 4 帧（封面 + 轮播幻灯片）。完整的 mediaItems[].preview_url + thumbnailUrl 会保留在 structuredContent 中，供模型推理。
• discover_social_posts / get_user_posts / analyze_creator_profile——每篇返回的帖子都会内嵌显示缩略图（一次最多 4 张），并附上标题 / 配文 + 浏览量 / 点赞数 / 评论数。说 “next” 或 “show more”——Claude 会使用 offset/limit 分页参数重新调用。说 “analyze the 2nd one”——Claude 会针对该 URL 调用 analyze_post 或 understand_social_post。
• 批量分析——要求“analyze all 4”或“understand these 3 in batch”，Claude 就会针对每个 URL 并行调用一次 analyze_post/understand_social_post，然后进行总结。对于较大的批次，可以先调用 discover_social_posts，再针对每个 URL 调用 analyze_post。

由你自己的模型来思考

没有其他模式。每个工具都会返回构建分析所依据的材料，费用就是获取这些材料的成本，然后由你的模型进行推理。这里没有任何内容会调用我们的模型，因此也不会向你兜售判断结果。

对于视觉工具，这意味着实际画面——真实的图像内容块，而非对它们的描述——并附带文字稿。在 Claude Code 上测得：每个 1280×720 画面约需 1,200 个 token；八个画面都能按顺序正确读取。20 个画面约占百万 token 上下文的 2.4%。

工具	返回内容	积分
analyze_post	画面图像，以及文字稿和统计数据	3（2 + 1）
summarize_post_comments	评论，每条都带有 ID，以及要使用的标签	2
analyze_creator_profile	创作者近期发布的内容及其数据	2
evaluate_social_draft	你的草稿，以及用于评分的标准	免费

上述价格根据每个工具实际执行的获取操作计算，而不是重复写死——参见 src/shared/evidence.ts 中的 EVIDENCE_PLANS 和 planCost。evaluate_social_draft 完全没有计划：它会审核你已有的文本，因此无需获取任何内容，也不会收费。

show_comment_review 用于完成整个流程：提交你的分类结果，它就会将其展示出来——每条评论都带有情绪倾向和类别，并且可以筛选和选择。免费，而且不会发出任何请求。

进行高成本调用前，会先征求同意

大多数工具会在自身描述中标明价格，因此调用的费用就是你已看到的价格。以下六种工具不会这样做，因为它们的价格由参数或请求中未提及的列表决定：

• search_mentions 按扫描的网络数量收费，因此仅说“监控我的品牌”就会扫描全部 9 个网络，费用为 21 积分。
• catch_up_watchlist 按创作者数量收费，因此价格取决于关注列表的长度。
• answer_my_audience、content_ideas_from_audience 和 measure_audience_overlap 按打开的帖子数量收费（使用默认值时分别为 14、12 和 16 积分），因此会在确认实际帖子数量后再询问，而不是按最坏情况收费。
• search_spoken_mentions 按网络数量、账号名称数量和文字稿数量收费，因此会按可能达到的最高费用征求同意。
• create_brand_watch 无论费用多低都会征求同意，因为你同意的是一笔周期性费用，而不是单次运行的费用。

前五种工具的费用超过 6 积分时，会先通过 MCP elicitation 征求同意——客户端会显示金额，由你接受或拒绝。拒绝不会产生费用，也不算错误。不支持 elicitation 的客户端不会因此受阻；调用仍会像以前一样执行。

两条规则的要求高于这个门槛。计划监控任务总会征求同意，因为需要审批的是长期有效的安排。而对于会通过电子邮件发送摘要的监控任务，如果没有人实际看到对话框并表示同意，就不会接受 deliverTo 地址——“无法征求同意”对于费用来说是合理的答复，但对于地址来说却不行。

前提条件

• Node.js >= 18（已在 Node 22 上测试）
• 一个 nooticr 账户（首次登录时自动创建——通过 npx @nooticr/mcp login 使用 Google 登录；不需要控制面板：对于新账户，服务端会自动创建默认工作区和应用）
• 可访问 nooticr 服务端——默认使用云 API （https://api.nooticr.com）；本地开发时，将 NOOTICR_BASE_URL 指向你自己的部署

快速开始

# 1. Sign in with your nooticr account (Google sign-in opens in your browser)
npx @nooticr/mcp login
#    or with email/password:
npx @nooticr/mcp login --email [email protected] --password '...'

# 2. Add it to your MCP client (see install section above) — or run it manually:
npx @nooticr/mcp            # stdio (default; for Claude Desktop / Cursor)
npx @nooticr/mcp --http     # remote HTTP with OAuth (for OpenAI Agents SDK)

login 会将你的 nooticr 令牌存储在 ~/.config/nooticr-mcp/credentials.json （权限模式为 0600）。如果无法自动打开浏览器，请手动将它打印出的 URL 复制到浏览器中打开。

在服务器上运行（无浏览器）

login 和 OAuth 流程都需要使用一次浏览器，而且都会留下一个由刷新令牌维持的 15 分钟访问令牌。对于在服务器端运行的集成来说，这种方式并不合适：那里无法完成同意页面，而刷新令牌链一旦中断，就必须手动修复。

API 密钥是另一种接入方式。可在浏览器中通过 mcp.nooticr.com/dashboard 创建——登录、为密钥命名并复制密钥；也可以在一台能够登录的设备上创建一次：

npx @nooticr/mcp login                                  # the one interactive step
npx @nooticr/mcp api-key create --name "aybee-prod"     # prints the key, once

然后将它提供给部署环境。无需进行其他配置，也无需刷新——该密钥会一直有效，直到你将其撤销。

# stdio, as a subprocess of your own service
NOOTICR_API_KEY=nk_... npx @nooticr/mcp

在服务器上，建议使用环境变量：所有容器运行时和密钥管理器都已支持注入环境变量，而且密钥不会留在会被重新部署清除的磁盘上。如果设置环境变量不太方便——例如在笔记本电脑上，或使用 Claude Desktop 这类不会继承 shell 环境的客户端——则可将密钥存储在凭据文件中：

npx @nooticr/mcp login --api-key nk_...

该命令会先向服务器验证密钥，再写入文件，因此输入错误时，你还可以当场修正。之后，它的行为与环境变量完全相同：无需浏览器、无需刷新，并且会一直有效，直到撤销。该文件只保存一个凭据，因此这会替换之前 login 留下的任何会话（而且 NOOTICR_API_KEY 仍具有更高优先级）。

# or against the remote endpoint, as an ordinary bearer token —
# no /authorize, no PKCE, no redirect URI
POST https://mcp.nooticr.com/mcp
Authorization: Bearer nk_...

可通过控制面板的 API keys 卡片或 CLI 管理密钥：

npx @nooticr/mcp api-key create --name "staging" --expires-in-days 90
npx @nooticr/mcp api-key list
npx @nooticr/mcp api-key revoke <id>

所有命令都支持 --json，便于脚本调用。以下几点值得注意：

• api-key create 只会显示一次密钥。nooticr 只存储其哈希值，之后无法再次显示；list 会显示密钥前缀（nk_1a2b3c4d…），方便区分密钥。
• 密钥的权限范围与创建者相同——包括其账户，以及当时所在的工作区（--workspace-id 可选择你所属的其他工作区）。
• 密钥不能创建或撤销密钥。这是有意为之：这样一来，即使密钥泄露，攻击者也无法创建一个在原密钥被撤销后仍然有效的新密钥。
• --expires-in-days 是可选参数。不设置时，密钥不会自动过期。
• 撤销操作会立即在 API 上生效。托管的远程端点会缓存“此密钥有效”的结果，最长五分钟；这最多只会让已撤销的密钥看到工具列表——所有涉及你账户的调用都会即时向 nooticr-server 验证。

在 Claude Desktop 中使用

运行 npx @nooticr/mcp login 后，将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "nooticr": {
      "command": "npx",
      "args": ["-y", "@nooticr/mcp"]
    }
  }
}

令牌会从 login 写入的凭据文件中读取（或从 NOOTICR_ACCESS_TOKEN 中读取）。如果你的客户端不会继承 shell 环境，请显式设置环境变量：

{
  "mcpServers": {
    "nooticr": {
      "command": "npx",
      "args": ["-y", "@nooticr/mcp"],
      "env": {
        "NOOTICR_BASE_URL": "http://localhost:8080"
      }
    }
  }
}

在 Cursor 中使用

在 .mcp.json（项目根目录）或 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "nooticr": {
      "command": "npx",
      "args": ["-y", "@nooticr/mcp"]
    }
  }
}

添加服务后，在终端中运行 npx @nooticr/mcp login——Cursor 会在继承你的环境的情况下启动服务，因此能够读取已存储的凭据。

对于远程/HTTP 用法，Cursor 可以连接到 OAuth 支持的 HTTP 模式：运行 npx @nooticr/mcp --http，并将服务 URL 指向 http://localhost:3457/mcp。远程客户端（包括 Cursor）会从 http://localhost:3457/.well-known/oauth-authorization-server 发现 OAuth 端点，打开“使用 Google 登录”页面，并存储生成的访问令牌。

搭配 OpenAI Agents SDK 使用

启动 HTTP 传输：

npx @nooticr/mcp --http --port 3457

Python：

from agents import Agent, Runner
from agents.mcp import RemoteMCPClient

async def main():
    async with RemoteMCPClient(
        url="http://localhost:3457/mcp",
        auth_provider="oidc",  # OAuth flow opens your browser once
    ) as client:
        agent = Agent(name="nooticr", mcp_servers=[client])
        result = await Runner.run(
            agent,
            "Analyze this video: https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        )
        print(result.final_output)

TypeScript（Agents SDK）：

import { Agent } from "agents";
import { RemoteMCPClient } from "agents/mcp/client";

const client = new RemoteMCPClient({
  url: "http://localhost:3457/mcp",
  authProvider: "oidc", // opens the browser for the OAuth flow
});

const agent = new Agent({
  name: "nooticr",
  mcpServers: [client],
});

const result = await agent.run(
  "Analyze this video: https://vm.tiktok.com/abc123/",
);
console.log(result.output);

使用 Agents SDK 运行本地 stdio 进程时，请使用 StdioMCPClient（Python： StdioMCPClient(command="npx", args=["@nooticr/mcp"])）。

命令行

nooticr-mcp                    Start in stdio mode (default transport)
nooticr-mcp --stdio            Same as above
nooticr-mcp --http [--port N]  Start the remote HTTP transport with OAuth (default port 3457)
nooticr-mcp login              Sign in to nooticr via Google in your browser
nooticr-mcp login --email ... --password ...   Password login
nooticr-mcp login --api-key nk_...             Sign in with an API key, no browser
nooticr-mcp api-key create [--name N] [--expires-in-days D] [--workspace-id W] [--json]
                               Mint a key for a server with no browser
nooticr-mcp api-key list [--json]         List this account's keys
nooticr-mcp api-key revoke <id> [--json]  Revoke one
nooticr-mcp --help             Show help

环境变量

变量	默认值	描述
NOOTICR_BASE_URL	https://api.nooticr.com	nooticr 服务基础 URL（会去除末尾斜杠）
NOOTICR_ACCESS_TOKEN	—	nooticr JWT 访问令牌；优先级高于以下所有选项
NOOTICR_API_KEY	—	通过 api-key create 创建的 nooticr API 密钥——无需浏览器、无需刷新，撤销前一直有效；优先级高于凭据文件（包括通过 login --api-key 写入其中的密钥）
NOOTICR_CREDENTIALS_FILE	~/.config/nooticr-mcp/credentials.json	令牌存储路径
NOOTICR_PUBLIC_URL	http://localhost:3457	在 OAuth 元数据中公布的公共基础 URL（HTTP 模式）
NOOTICR_PORT	3457	--http 和 login 使用的端口
NOOTICR_TRANSPORT	stdio	stdio 或 http（与 --http 相同）

身份验证的工作方式

stdio 模式（Claude Desktop、Cursor）：服务使用它找到的第一个凭据——依次为 NOOTICR_ACCESS_TOKEN、NOOTICR_API_KEY，然后是 login 写入的凭据文件。该文件中只保存一个凭据，即最近一次 login 写入的凭据：API 密钥（login --api-key）或会话。过期的会话令牌会通过已存储的刷新令牌进行刷新；nooticr API 返回 401 时，会在刷新后重试一次。无论 API 密钥来自哪里，都不会刷新：它不会过期，因此密钥对应的 401 表示密钥已撤销或输入有误，重试只会掩盖问题。

API 密钥（任意传输方式，无需浏览器）：将其作为 Bearer 令牌发送，或设置 NOOTICR_API_KEY。nooticr-server 会将密钥解析为其所有者及其限定作用域的工作区，下游的每项授权检查所看到的内容都与已登录会话完全相同。请参阅在服务上运行。

HTTP 模式（OpenAI Agents SDK、远程客户端）：服务运行自己的 OAuth 2.0 授权服务（授权码 + PKCE S256，公共客户端，符合 MCP 2025-03-26 规范）：

• GET /.well-known/oauth-authorization-server — 元数据
• GET /authorize — 验证请求（回环或 https 重定向 URI），并将浏览器转发至 nooticr 的 Google 登录页面
• GET /oauth/callback — 我们自己的回环回调；将 nooticr 的完成码兑换为 nooticr JWT，并使用一次性代码重定向回 MCP 客户端
• POST /token — 验证 PKCE，并签发绑定到 nooticr 会话的不透明 Bearer 令牌（有效期为 1 小时）
• 每个 MCP RPC 都会根据会话映射验证 Bearer 令牌；如果 Bearer 令牌是 API 密钥，则会将其作为调用方自己的凭据转发给 nooticr-server，这正是该端点无需浏览器即可使用的原因

支持的 URL

• TikTok：tiktok.com/*、vm.tiktok.com/*（以及 www./m. 子域名）
• Instagram：instagram.com/*（Reels、帖子、轮播图）、instagr.am/*
• YouTube：youtube.com/*（包括 /shorts/）、youtu.be/*、m.youtube.com/*
• X：x.com/*、twitter.com/*
• Reddit：reddit.com/*、redd.it/*
• Weibo：weibo.com/*、weibo.cn/*
• Douyin：douyin.com/*
• Xiaohongshu：xiaohongshu.com/*、xhslink.com/*
• Bilibili：bilibili.com/*、b23.tv/*
• LinkedIn：linkedin.com/*（帖子、个人资料 URL）

所有工具都接受这些主机，并可处理视频、图片、轮播图、幻灯片和文本帖子。

故障排除

• Not authenticated with nooticr / 401：运行 npx @nooticr/mcp login，或 设置 NOOTICR_API_KEY（请参阅在服务器上运行）。
• unknown, revoked or expired nooticr API key：此密钥并非此 账户当前有效的密钥。npx @nooticr/mcp api-key list 会显示所有密钥及其 状态，包括已撤销的密钥。
• API keys cannot manage API keys：api-key create/list/revoke 需要 已登录的会话，因此会忽略 NOOTICR_API_KEY 中的密钥，也会忽略 通过 login --api-key 保存的密钥。请先运行 npx @nooticr/mcp login。
• 402 付费墙 / insufficient MCP credits：你的 nooticr 账户余额不足。 工具中列出了各工具的价格：查询帖子或获取文字稿需 1 个点数， 发现内容及执行一次抓取的工具需 2 个点数，抓取帧和文字稿的两个工具需 3 个 点数。每个工具从首次调用起就会计费。可通过 check_nooticr_credits 充值，或访问 nooticr 控制面板： https://nooticr.com/settings?tab=billing。
• 刷新令牌已过期：nooticr 服务拒绝了已保存的刷新令牌。请再次运行 npx @nooticr/mcp login 重新进行身份验证。
• Could not reach the nooticr server：无法访问 NOOTICR_BASE_URL，或该地址有误。
• 客户端在 HTTP 模式下显示“Bad Request”或连接错误：确保端口与 NOOTICR_PUBLIC_URL 相符，并确保客户端先获取了令牌 （OAuth 流程必须先在浏览器中完成一次）。

平台提交

请参阅 docs/SUBMISSION.md，其中包含可直接粘贴的配置，以及适用于 Claude Desktop、Cursor 和 OpenAI Agents SDK 的提交包。

每次发布后，官方 MCP 注册表条目 com.nooticr/mcp 的版本必须与 server.json 中的版本一致；版本漂移检查（npm run registry:check）和发布脚本（npm run registry:publish）请参阅 docs/registry-publishing.md。

安全说明

• 凭据文件以 0600 权限写入，目录权限为 0700。
• OAuth 重定向 URI 仅限环回地址（http://localhost、 http://127.0.0.1、http://[::1]）或 https:// URL；/authorize 端点要求使用 PKCE（S256）。
• 授权码和 PKCE 挑战只能使用一次，且有效期很短 （保存在内存中）。
• 访问令牌是不透明的随机字符串，并绑定到内存中的会话映射； 有效期为 1 小时。重启服务会使所有会话失效。
• API 密钥以 sha256 哈希形式存储，不会以明文保存，因此数据库转储 无法用于重放 API 请求。API 密钥仅适用于一个账户和一个 工作区，其携带的所有者角色反映的是当前角色，而非创建密钥时的角色，并且 不能用于创建或撤销密钥。
• 切勿分享你的凭据文件、NOOTICR_ACCESS_TOKEN 或 NOOTICR_API_KEY。

开发

npm install
npm run build    # tsc
npm test         # vitest (66 unit tests, mocked fetch — no network)

这些是针对存根后端运行的单元测试。若要运行真正的 MCP 协议 端到端测试——无需 Rust、无需 Postgres、无需 API 密钥—— npm run test:e2e-smoke:fixture 会启动此仓库中实际构建的 CLI，并通过 stdio 驱动它，对接纯 Node.js 实现的 nooticr-server 替代服务。除此之外， 更高一级的测试（对真实 nooticr-server 运行 npm run test:e2e-smoke）请参阅 docs/testing/agentic-e2e-testing.md。若要让真实模型通过完整流程驱动服务， 并断言它遍历的工具调用链，而非单次调用，请参阅 npm run test:quests 和 docs/testing/tool-chaining-quests.md。对于 tests/e2e/agentic-visual*.e2e.ts，它会遍历所有可访问的组件视图， 由真实工具调用结果驱动，在真实浏览器中渲染，并实际点击面向宿主的每个 按钮（npx playwright test tests/e2e/agentic-visual.e2e.ts tests/e2e/agentic-visual-full-app.e2e.ts）。这项测试发现了 6 个真实的 产品缺陷，相关文档见同一文件。

许可证

MIT