前言¶

出海或跨境团队做 influencer / creator marketing 时，常见路径是：在 NoxInfluencer（聚星）里搜红人、导出名单、再切到 Campaign、邮件、CRM 和监控面板里逐项操作。人在多个 SaaS 页面之间复制 ID、核对配额，Agent 若缺少结构化指引，也容易把「搜人」和「发信」「改 Campaign」混在一套臆测参数里。

下面介绍 SkillHub 上的社区 Skill「Nox聚星网红营销云 - 红人发现 & 建联营销」（坐标 @user_d9fb4c11/nox-influencer-marketing，当前版本 1.0.13）。它把 Nox 官方 CLI @noxinfluencer/cli 的能力写进 SKILL.md，让 Cursor、Claude Code、Codex 等 Agent 按同一套路由规则执行查询、评估、建联与营销运维，而不是让用户自己记命令行。

这是什么¶

一句话定位：面向 NoxInfluencer 的 Agent 执行层 Skill——用户用自然语言描述业务意图，由 Agent 在本地调用 noxinfluencer CLI，返回可核验的 ID、配额状态与业务可读结果。

• 出品与分发：SkillHub 社区发布（community），发布者 user_d9fb4c11；分类为 business-ops；页面标注 requires_api_key=true，需完成 Nox 账号鉴权后方可调用 API。
• 依赖：Skill 元数据要求本机已安装可执行文件 noxinfluencer，对应 npm 包 @noxinfluencer/cli；官方 Skill 说明页：https://www.noxinfluencer.com/skills。
• 平台范围：Skill 说明覆盖 YouTube、TikTok、Instagram 上的达人情报与营销运维（部分品牌监测能力在说明中写明仅 YouTube 支持产品信号类命令，以 CLI schema 为准）。

核心功能¶

以下能力均来自 Skill 官方 SKILL.md 与 SkillHub 简介，按业务域归纳。

红人发现与名单¶

• 搜索与筛选：creator search、搜索筛选项与分页；支持按名称或话题关键词检索（二者不可混用）；可配合合作状态、CRM、已联系范围、收藏夹等 SaaS 侧过滤。
• 相似达人：creator lookalikes 及对应导出。
• 评估阅读：creator profile / audience / content / cooperation 等只读分析；Skill 内置「结论先行」的评估框架（高优 / 可行但有风险 / 需人工 / 非优先）。
• 结果导出：在用户选定 1–100 个 creator_id 后，creator export / creator lookalikes-export；深度导出可先 export-preview 估算配额。

联系方式与建联边界¶

• 联系人：仅在用户明确要求导出可见联系方式时调用 creator contacts；平台内邮件建联默认用 creator_id 填入邮件任务收件人，而非先拉邮箱。
• 邮件与消息：独立邮件任务（type 3）的创建与更新；message send / schedule 面向已有会话线程。智能 Campaign 的固定三类收件人任务需在 SaaS 页面维护，CLI 侧有明确边界说明。

内容与品牌监测¶

• 视频监控：monitor 系列（项目、任务、历史、汇总、报表）；对已发布 URL 加任务；monitor auto-track 用于持续跟踪达人新发布内容；支持表格导入（失败行需修正后重试）。
• 品牌监测：brand-monitor（竞品/自有品牌分析、资产导出等），与以 creator_id 为主的尽调路径区分。

营销运维与附属能力¶

• 运营对象：campaign、collection、crm、product、short-link、affiliation（含 Shopify 联盟相关读写；店铺授权缺失时引导用户到 SaaS 完成）。
• 导出与文件：异步 export 轮询下载；部分报表（monitor、short-link、affiliation）支持直接 Excel 到本地路径；file 处理公开图与私有附件。
• 协作与治理：dispute 用于具体合作纠纷举证（与 feedback 产品反馈区分）；quota、pricing tools 查配额与按动作计费；feedback submit 提交问题且不消耗 Skill 配额。

Agent 侧原则在 Skill 中写得很清楚：用户不直接操作 CLI，由 Agent 静默执行；仅在登录、订阅等需要浏览器动作时给出 URL。参数以 CLI 自描述为准：noxinfluencer schema <cmd>、--help、doctor。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行（完整安装含默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 将 Skill 装到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 路径，否则默认落在 ./skills/ 且 Agent 可能读不到。SkillHub 文档给出的常见路径：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

安装本 Skill 的命令（与 SkillHub 搜索结果一致）：

skillhub install nox-influencer-marketing --namespace user_d9fb4c11 --dir ~/.cursor/skills

将 ~/.cursor/skills 换成你实际使用的 Agent 目录。SkillHub 页面也支持把下面这句交给 AI，让其按 https://skillhub.cn/install/skillhub.md 完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_d9fb4c11/nox-influencer-marketing。

安装后一般需要重启或重新加载对应 Agent，才能加载新 Skill。

3. 安装 Nox CLI 并完成鉴权¶

Skill 依赖本机 noxinfluencer 命令。按 Skill 入门流程，缺 CLI 或命令树过旧时安装：

npm install -g @noxinfluencer/cli@latest
noxinfluencer schema --all

健康检查与鉴权：

noxinfluencer doctor
noxinfluencer auth status

在 Agent 或远程终端中，推荐 Device Flow（避免在日志里暴露密钥）：

noxinfluencer login start --json
# 将 verification_uri_complete 与 user_code 交给用户在浏览器完成授权后：
noxinfluencer login wait <login_id>

本地可直接交互的终端也可用 noxinfluencer login。API Key 仅作兜底，通过 auth --key-stdin 写入，不要放在命令行参数里。

国内站点路由可加 --lang zh，Skill 说明会将相关 URL 切到 cn.noxinfluencer.com。

典型用法¶

Skill 的设计是自然语言驱动，下面步骤体现官方推荐的起手式与可核对命令，便于你在装好后自测环境。

环境自检¶

noxinfluencer doctor
noxinfluencer quota

若有阻断性配额或权益问题，CLI 响应中的 action.url / action.hint 应转给用户处理。

查命令参数（避免死记 flag）¶

例如红人搜索：

noxinfluencer schema creator.search
noxinfluencer creator search --help

计费相关：

noxinfluencer pricing tools --charged-only
noxinfluencer quota usage --days 7

预览请求而不真正扣费（适用支持 --dry-run 的命令）：

noxinfluencer <cmd> --dry-run

与 Agent 协作的表述方式¶

在 Cursor 等客户端中启用 Skill 后，可以直接描述业务目标，例如：

1. 「在 TikTok 上按关键词 X、地区 Y 搜一批有邮箱信号的达人，先给 5 个对比摘要。」
2. 「用已有的 creator_id 做受众与内容表现评估，给出是否值得建联的结论。」
3. 「为这批已选 ID 创建标准列导出，导出前先 preview 配额。」
4. 「给独立邮件任务添加收件人（用 search 返回的 id），不要导出联系方式。」

Agent 应按 Skill 路由表选择 creator search、creator profile、 creator export-preview / export 等命令族，并在营销写操作前走 validate → preview → 用户确认后再 apply --force。

适用场景与注意¶

更适合谁

• 已使用或计划使用 NoxInfluencer（聚星）做红人营销、UGC、社媒与联盟推广的团队。
• 希望把「搜人 → 评估 → 建联 → Campaign/CRM/邮件/监控」串在 Agent 对话里，且愿意由 Agent 代执行 CLI 的运营同学或开发者。

限制与坑（来自官方 Skill 说明）

• 必须 API Key / 登录：无有效鉴权时只能走到 doctor、登录引导等本地步骤。
• 配额与计费：搜索、相似达人等按返回达人数量计费；联系人、邮件服务等另有 SaaS 侧配额；执行前可用 pricing / quota usage 做规划。
• CLI 能力边界：智能 Campaign 的固定邮件任务不能靠 CLI 安全改写；Shopify 店铺授权需在 SaaS 完成；品牌监测部分能力平台受限。
• 数据与合规：creator contacts 仅在明确需要导出可见联系方式时使用；纠纷上报 dispute 需付费会员且要截图证据，与 feedback 用途不同。
• 版本：以 SkillHub 页面为准当前为 1.0.13；CLI 建议保持 @noxinfluencer/cli@latest 并与 schema --all 对照 Skill 要求的命令树（含 creator、monitor、campaign、email、crm、brand-monitor 等）。

SkillHub 页面上该 Skill 评分 100000，下载 1208 次（统计随 SkillHub 更新而变化）。

结尾¶

「Nox聚星网红营销云 - 红人发现 & 建联营销」把 NoxInfluencer 的 CLI 能力固化成 Agent 可遵循的操作手册：发现与评估红人、在明确边界内做建联与营销运维、处理监控与导出，并统一走鉴权、配额与错误 action 指引。若你的工作流已经落在聚星上，用 SkillHub 安装到对应 Agent 的 skills 目录，再配好 noxinfluencer 登录，即可把重复点击 SaaS 变成可复述的对话任务。

• SkillHub 页面：https://www.skillhub.cn/skills/user_d9fb4c11/nox-influencer-marketing
• API / 安装坐标：https://api.skillhub.cn/user_d9fb4c11/nox-influencer-marketing
• Nox Skill 说明：https://www.noxinfluencer.com/skills