WotoKOL CLI

Cross-platform command-line client for discovering overseas creators from natural-language requirements. It returns compact creator basics and AI profile summaries from WotoKOL semantic search.

Requirements

• Node.js 18 or newer on macOS, Linux, or Windows
• Network access to https://api.wotohub.com
• A WotoKOL account (an existing account or a new registration)

Install

After the npm package is published:

npm install --global @wotokol/cli
wotokol doctor

For local development:

npm install --global .
wotokol doctor

Sign in from the browser

Start device authorization:

wotokol login start --json

Open the returned verificationUriComplete, sign in or register, verify the displayed code, and explicitly confirm access. Then use the returned loginId:

wotokol login wait <login_id>
wotokol doctor

The browser never receives the device secret or API Key. The CLI stores the pending device secret and final credential in the current user's private configuration directory and does not print either value.

If device authorization is unavailable, the standard-input command remains as a fallback:

wotokol auth --key-stdin

Write the Key only to the running process's standard input. The CLI never accepts it as a command-line argument or prints it to stdout or stderr. Agent conversations and tool inputs may be retained by the Agent platform, so rotate a Key if it is exposed unexpectedly.

WOTOKOL_API_KEY remains available for CI and terminal environments and takes precedence over a saved Key.

macOS or Linux:

export WOTOKOL_API_KEY="your-api-key"

Windows PowerShell:

$env:WOTOKOL_API_KEY = "your-api-key"

Windows Command Prompt:

set WOTOKOL_API_KEY=your-api-key

Run wotokol doctor to confirm setup. Do not pass the Key as a command-line argument or commit it to a repository.

Search creators

wotokol creator search \
  --description "Find US TikTok beauty tutorial creators with at least 100K followers" \
  --page 1 \
  --page-size 20

Inspect the machine-readable command contract:

wotokol schema creator.search

The CLI calls https://api.wotohub.com/api-gateway/search/naturalSearch and sends the Key through the api-key request header. It writes each result as one compact JSON document to stdout and waits for the write to finish; diagnostics go to stderr. Creator output omits avatarUrl and blogTagsAi. Exit code 2 indicates invalid arguments or missing configuration; exit code 1 indicates an API or runtime failure.

Verify and publish

npm test
npm pack --dry-run
npm publish --access public

Publishing requires access to the @wotokol npm organization.

License

Licensed under the Apache License 2.0.

This license covers only the source code in this repository. Use of the WotoKOL API, creator data, and hosted services is governed separately by WotoKOL's service terms. The license does not grant permission to use WotoKOL trademarks or logos except as allowed by the license.