@noxinfluencer/cli

NoxInfluencer CLI for creator discovery, creator analysis, platform email outreach, external contact lookup, video monitoring, marketing operations, Shopify affiliate marketing, product center, brand monitoring, user feedback, skill quota inspection, and membership plan lookup.

Install

Global install:

npm install -g @noxinfluencer/cli

One-off execution:

npx @noxinfluencer/cli --help

After installation, the executable command is:

noxinfluencer

Requirements

• Node.js 18+
• Access to a compatible KOL Claw server
• A valid API key

Quick Start

If you are starting from scratch:

1. Sign in and authorize the CLI:

noxinfluencer login

The CLI prints an authorization URL and opens it when possible. Complete SaaS login/registration and authorization in any browser; the CLI then creates or reuses a non-expiring API key and saves it locally.

For an Agent, container, or remote terminal, return the URL to the user first and wait separately:

noxinfluencer login start --json
noxinfluencer login wait <login_id>

login start never opens a browser and never prints the secret device code. Use noxinfluencer login --browser only when a local loopback callback is available.

2. Manual fallback: get your API key:

• English: https://www.noxinfluencer.com/skills/dashboard?utm_source=skill&utm_medium=cli
• Chinese: https://cn.noxinfluencer.com/skills/dashboard?utm_source=skill&utm_medium=cli

Then configure it securely:

printf '%s\n' "$NOXINFLUENCER_API_KEY" | noxinfluencer auth --key-stdin

For CLI-generated onboarding URLs and hints in Chinese, add --lang zh:

noxinfluencer --lang zh doctor

Check quota:

noxinfluencer quota
noxinfluencer quota usage --days 7

Check pricing:

noxinfluencer pricing
noxinfluencer pricing tools --charged-only

Search creators:

noxinfluencer creator search --platform youtube --keywords '[beauty,skincare]' --page_size 3
noxinfluencer creator search --platform youtube --creator_name "MrBeast" --page_size 5
noxinfluencer creator search --platform tiktok --keywords '[coffee,review]' --keyword_match all
noxinfluencer creator search --platform instagram --keywords '[books]' --exclude_keywords '[parenting]' --hide_cooperated --hide_contacting --hide_contacted_scope team

API-backed skill calls can consume both:

• the account's remaining Skill quota
• the underlying SaaS-side capability quota / entitlement for the requested operation

Core Commands

• login - device authorization sign-in that saves an API key locally; use login start|status|wait for Agents, or login --browser for a local loopback PKCE shortcut
• auth - save API key
• quota / quota usage - show the current Skill quota snapshot and historical consumption statistics
• pricing / pricing tools - show public membership plans and current server-side Skill Credit unit prices
• creator search - search creators on YouTube, TikTok, or Instagram by either topic --keywords or one --creator_name; supports topic exclusions plus the SaaS completed-cooperation, active-cooperation, CRM-communication, contacted-scope, and collection filters in the same request; defaults to page_size=20, supports up to --page_size 100, and charges only for returned creators; search results do not expose creator identity fields beyond search item id
• creator search --exclude_disputed - omit creators with recorded disputes when building an outreach shortlist
• creator search-filter / creator search-filter-options - inspect SaaS hide/deduplication choices or apply them to an already returned result page; prefer integrated creator search --hide_* for new searches
• creator not-interested list|add|remove - mark selected encrypted creator IDs as Not interested, inspect the user-scoped list, or remove that mark; writes default to dry-run and are free
• creator lookalikes [source_creator_id] - find similar creators from a source creator ID, source URL, or --source-platform --source-channel-id; requires --target-platform and supports up to --page_size 100
• creator export / creator lookalikes-export - export 1-100 explicitly selected creator IDs from search or lookalike results in SaaS base or deep mode; poll and download through the shared export commands
• creator export-preview - use the same deep-export body to preview SaaS export/contact quota without creating a task or consuming Skill Credit
• creator profile [creator_id] / creator profile --detail - choose exactly one selector: [creator_id], --url, or --platform --channel-id; creator read responses include creator_id, creator_name, channel_handle, channel_url, and social_media
• creator audience [creator_id] / creator audience --detail - choose the same selector modes
• creator cooperation [creator_id] / creator cooperation --detail - choose the same selector modes
• creator content [creator_id] / creator content --detail - choose the same selector modes
• creator contacts [creator_id] - retrieve visible/exportable contact info for external outreach; NoxInfluencer email tasks should add search/profile creator_id values directly instead
• monitor list|create|add-task|import-file|import-report|report|dashboard-report|task-report|tasks|history|summary - manage published-content monitoring, including SaaS Excel imports and reports
• monitor auto-track list|get|import-file|import-template|import-report - create and inspect rules that automatically monitor newly published creator content; file imports are all-or-nothing
• monitor tasks - list monitored videos in a project; task items return the same creator identity fields
• monitor history - get task-level history points by task_id with --granularity daily|hourly
• monitor summary - get project-level aggregated summary
• campaign list|get|init|create|update|delete|dropdown|dashboard|product-images - manage campaign skeleton data and upload product images to public OSS; write commands default to dry-run
• collection list|get|create|update|delete|items|resources|export - manage collections and create async export tasks; items/resources/export stay JSON-first via --body-file
• collection add-creators - add creators returned by search/read commands to one or more collections
• collection import-file - import the user's owned creator URLs into one collection from a spreadsheet
• collection batch-delete|batch-move|batch-copy|batch-label validate|preview|apply - single-source batch ops; use validate to check selector and target wiring, preview to inspect matched_count and sample_rows, then apply --force to execute
• collection refresh|refresh-email|unlock-audience validate|preview|apply - single-source high-side-effect ops; reuse the same selector contract as batch commands, and use preview before apply --force
• collection add-to-crm validate|preview|apply - whole collection + platform only in v1; no filtered or explicit channel subset support
• crm list|get|update|archive|restore|import-file|import-report|labels|groups|batch-update|export|add-to-email - manage NoxInfluencer CRM channels, SaaS-format spreadsheet imports and reports, labels, groups, batch status/label updates, exports, and email recipient bridging
• email list|get|create|update|copy|delete|recipients|content|sender|templates|products|attachments|collaborators|send|schedule|cancel|report|team-summary|team-breakdown - manage email tasks, recipients, content, sender identity, templates, product cards, private attachments, collaborators, sending, scheduling, and reporting; use email sender list [task_id] to discover Gmail, Outlook, enterprise, or Nox sender IDs safely
• email recipients filter|import-file - read or update task-level SaaS recipient hide/deduplication settings, or import recipients from a SaaS-format Excel file
• message list|project-filters|creator-filters|get|projects|archive|labels|coop|draft|attachments|send|schedule|cancel|templates - manage existing NoxInfluencer message threads, replies, and whole-creator conversation archive; message archive is separate from CRM archive
• product list|get|analyze-link|create|update|delete|image|tags - manage product center records, public thumbnail uploads, and custom tags
• short-link list|get|create|update|delete|export-list|export-effect - manage normal Nox short links and stream SaaS-generated Excel reports; Shopify affiliate campaign tracking links are separate
• affiliation stores|campaigns|members - manage Shopify affiliate stores after SaaS authorization, campaigns, members, spreadsheet imports, tracking links, discount codes, and performance reads; store authorization stays in SaaS
• brand-monitor search|rank|list|get|competition-matrix|cooperate-matrix|influencer-portrait|defense-gap|product-*|*-list|*-export|add|unlock-base|unlock-high - discover brands globally, then read and manage account brand-monitor data and exports
• feedback submit|list|inbox|get|reply|notifications|attachments - send free product feedback, bugs, usage questions, or feature requests; supports screenshot/log upload and owned attachment download
• dispute options|search|mine|records|get|report|update|withdraw - review creator collaboration dispute history, then submit evidence-backed reports or manage your own pending reports; requires paid membership but consumes no Skill Credit
• export list|get|download - inspect creator, collection, CRM, and brand-monitor export tasks and directly download authorized files; export download requires --output

For the first lookup, use --url or --platform --channel-id. All creator read commands return data.creator_id; reuse that value for follow-up calls.

Examples:

noxinfluencer creator profile --url https://www.youtube.com/channel/UC4qk9TtGhBKCkoWz5qGJcGg
noxinfluencer creator profile --platform youtube --channel-id UC4qk9TtGhBKCkoWz5qGJcGg
noxinfluencer creator profile <creator_id>
noxinfluencer collection batch-copy preview --body-file batch-copy.json
noxinfluencer collection batch-copy apply --body-file batch-copy.json --force
noxinfluencer collection refresh-email preview --body-file refresh-email.json
noxinfluencer collection unlock-audience apply --body-file unlock-audience.json --force
noxinfluencer collection add-creators --body-file add-creators.json --force
noxinfluencer collection import-file <collection_id> --file creators.xlsx --force
noxinfluencer collection add-to-crm apply --body-file add-to-crm.json --force
noxinfluencer collection export --body-file export.json --force
noxinfluencer monitor import-file --project_id 7101 --file monitor.xlsx --force
noxinfluencer monitor import-report --body-file monitor-failures.json --output invalid-tasks.xlsx
noxinfluencer monitor auto-track import-file --project_id 7101 --rule_name "Hisense launches" --keywords '[Hisense,TV]' --file influencers.xlsx --force
noxinfluencer monitor report --body-file monitor-report.json --output monitor-report.xlsx
noxinfluencer monitor dashboard-report --body-file dashboard-report.json --output dashboard.xlsx
noxinfluencer monitor task-report 9120 --start-date 2026-07-01 --end-date 2026-07-15 --output task-report.xlsx
noxinfluencer crm import-file --file crm-import.xlsx --force
noxinfluencer crm import-report --body-file crm-import-report.json --output crm-failed.xlsx
noxinfluencer email collaborators list
noxinfluencer email recipients filter options
noxinfluencer email recipients import-file <task_id> --file recipients.xlsx --force
noxinfluencer message templates attachments upload <template_id> --file brief.pdf --force
noxinfluencer message templates use <template_id> --body-file template-use.json --force
noxinfluencer product image upload --file product.jpg --force
noxinfluencer product list
noxinfluencer campaign product-images upload --file campaign-product.jpg --force
noxinfluencer short-link create --body-file short-link.json --force
noxinfluencer short-link get <short_link_id>
noxinfluencer short-link export-list --body-file short-link-export.json --output short-links.xlsx
noxinfluencer short-link export-effect <short_link_id> --output short-link-effect.xlsx
noxinfluencer affiliation stores list
noxinfluencer affiliation campaigns list --store-id <store_id>
noxinfluencer affiliation members add <campaign_id> --body-file affiliation-members.json --force
noxinfluencer affiliation members import-file <campaign_id> --file affiliation-members.xlsx --force
noxinfluencer feedback submit --message "Email reply count looks wrong" --category bug --file screenshot.png --force
noxinfluencer feedback inbox
noxinfluencer dispute records <creator_id>
noxinfluencer dispute report --body-file dispute-report.json --file evidence.jpg --force
noxinfluencer dispute mine --review_statuses '[1]'
noxinfluencer export get <export_id>
noxinfluencer export download <export_id> --output ./export.xlsx
noxinfluencer monitor history --task_id <task_id> --granularity daily --start_date 2026-03-20

Creator Result Exports

Export selected search results with the encrypted IDs returned in data.items[].id:

{
  "platform": "youtube",
  "mode": "deep",
  "creator_ids": ["<data.items[0].id>", "<data.items[1].id>"],
  "field_keys": ["username", "kol_link", "followers"]
}

noxinfluencer creator export-preview --body-file creator-export.json
noxinfluencer creator export --body-file creator-export.json --force
noxinfluencer export get <export_id>
noxinfluencer export download <export_id> --output ./creators.xlsx

For lookalikes, reuse the response data.export_context unchanged so the export reruns the same filters:

{
  "mode": "base",
  "creator_ids": ["<data.items[0].id>"],
  "export_context": {
    "source_creator_id": "<data.export_context.source_creator_id>",
    "platform": "instagram",
    "country": ["US"]
  }
}

noxinfluencer creator export-preview --body-file lookalikes-export.json
noxinfluencer creator lookalikes-export --body-file lookalikes-export.json --force
noxinfluencer export get <export_id>
noxinfluencer export download <export_id> --output ./lookalikes.xlsx

All selected IDs must match the export platform. Base mode uses the SaaS base columns; deep mode requires platform-supported field_keys. Contact fields such as email and whatsapp can consume contact quota and should only be requested for external outreach.

Run help for the full command list:

noxinfluencer --help

Global Options

• --lang <code> - choose user-facing URLs and hints (zh uses cn.noxinfluencer.com, others use www.noxinfluencer.com)
• --json / --plain - switch output format
• --trace-json - emit structured request traces to stderr
• --dry-run - preview the request without executing it

Proxy Support

The CLI reads standard proxy environment variables and routes requests through undici with an explicit proxy dispatcher. NODE_USE_ENV_PROXY=1 is not required.

export HTTPS_PROXY=http://127.0.0.1:10808
export HTTP_PROXY=http://127.0.0.1:10808
export NO_PROXY=127.0.0.1,localhost

Notes:

• HTTPS_PROXY is used for online Skill API requests
• HTTP_PROXY is used for local or non-TLS server URLs
• ALL_PROXY is only used as a fallback when it is an http:// or https:// proxy URL
• socks5:// in ALL_PROXY is not supported by the current CLI transport

Publish Checklist

Before publishing:

npm run pack:check

For the first public release of this scoped package:

npm login
npm publish --access public