前言¶
出海或跨境團隊做 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 後，可以直接描述業務目標，例如：
- 「在 TikTok 上按關鍵詞 X、地區 Y 搜一批有郵箱信號的達人，先給 5 個對比摘要。」
- 「用已有的
creator_id做受衆與內容表現評估，給出是否值得建聯的結論。」 - 「爲這批已選 ID 創建標準列導出，導出前先 preview 配額。」
- 「給獨立郵件任務添加收件人（用 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 變成可複述的對話任務。
