@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 through your browser:

noxinfluencer login

The CLI opens NoxInfluencer in your browser, reuses your SaaS login session, creates or reuses a non-expiring API key, and saves it locally.

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

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 - browser-based sign-in that saves an API key locally
• 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; use --keyword_match all when every topic keyword must match; defaults to page_size=20, supports up to --page_size 100, and charges by returned creator count; search results do not expose creator identity fields beyond search item id
• creator search-filter / creator search-filter-options - apply SaaS hide/deduplication rules to the current search result page
• 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 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 / monitor create / monitor add-task - manage monitoring projects and tasks; monitor add-task defaults to 60 monitor days and returns creator_id, creator_name, channel_handle, and channel_url when upstream task data includes them
• 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 - manage campaign skeleton data; write commands use --body-file and 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|labels|groups|batch-update|export|add-to-email - manage NoxInfluencer CRM channels, labels, groups, batch status/label updates, exports, and email recipient bridging
• email list|get|create|update|copy|delete|recipients|content|sender|templates|products|collaborators|send|schedule|cancel|report|team-summary|team-breakdown - manage email tasks, recipients, content, sender identity, templates, product cards, collaborators, sending, scheduling, and reporting
• email recipients filter - read or update task-level SaaS recipient hide/deduplication settings
• message list|project-filters|creator-filters|get|projects|labels|coop|draft|send|schedule|cancel|templates - manage existing NoxInfluencer message threads, SaaS-aligned list filters, and replies
• product list|get|analyze-link|create|update|delete|tags - manage product center records and custom tags
• short-link list|get|create|update|delete - manage normal Nox short links; Shopify affiliate campaign tracking links are separate
• affiliation stores|campaigns|members - manage Shopify affiliate stores after SaaS authorization, campaigns, members, tracking links, discount codes, and performance reads; store authorization stays in SaaS
• brand-monitor list|get|competition-matrix|cooperate-matrix|influencer-portrait|defense-gap|product-*|*-list|*-export|add|unlock-base|unlock-high - read and manage brand monitor data and exports
• feedback submit|list|inbox|get|reply|notifications - send free product feedback, bugs, usage questions, or feature requests; supports screenshots/logs via --file and async follow-up via inbox/get
• export list|get|download - inspect export tasks and download ready 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 email collaborators list
noxinfluencer email recipients filter options
noxinfluencer product list
noxinfluencer short-link create --body-file short-link.json --force
noxinfluencer short-link get <short_link_id>
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 feedback submit --message "Email reply count looks wrong" --category bug --file screenshot.png --force
noxinfluencer feedback inbox
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

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