Skip to main content
The creator commands are currently in planning/development. The CLI entry point references these commands, but the implementation modules do not yet exist in the codebase.

​
Overview

The creators command group is planned to provide CLI access to creator management operations. This will enable developers to manage creator profiles, sync data, and perform bulk operations from the command line.

​
Planned Commands

The following commands are planned for implementation:

​
List Creators

# Planned: List all creators
tiktok-miner creators list [options]
Options:
  • --platform <platform> - Filter by platform (tiktok, instagram, twitter, youtube)
  • --min-followers <count> - Minimum follower count
  • --min-engagement <rate> - Minimum engagement rate
  • --category <category> - Filter by category
  • --limit <number> - Limit results
  • --format <json|csv|table> - Output format

​
View Creator Details

# Planned: Get detailed information about a creator
tiktok-miner creators view <username> [options]
Options:
  • --platform <platform> - Specify platform
  • --include-metrics - Include historical metrics
  • --include-posts - Include recent posts

​
Sync Creator Data

# Planned: Update creator data from platforms
tiktok-miner creators sync <username> [options]
Options:
  • --platform <platform> - Platform to sync
  • --force - Force full re-sync
  • --metrics-only - Only sync metrics

​
Export Creator Data

# Planned: Export creator data
tiktok-miner creators export [options]
Options:
  • --format <csv|json|xlsx> - Export format
  • --output <file> - Output file path
  • --fields <fields> - Comma-separated field list
  • --filter <expression> - Filter expression

​
Current Workaround

While these commands are being implemented, you can access creator data using the query-db command:

​
List Creators via SQL

bun cli/index.ts query-db "SELECT username, \"followerCount\", \"engagementRate\", platform FROM \"TiktokProfile\" ORDER BY \"followerCount\" DESC LIMIT 20"

​
Get Creator Details via SQL

bun cli/index.ts query-db "SELECT * FROM \"TiktokProfile\" WHERE username = 'techguru'"

​
Get Cross-Platform Creator Data

bun cli/index.ts query-db "
SELECT 
  cp.name,
  cp.\"totalReach\",
  cp.\"averageEngagementRate\",
  cp.\"platformIdentifiers\"
FROM \"CreatorProfile\" cp
WHERE cp.name LIKE '%Tech%'
LIMIT 10
"

​
Web Interface Alternative

For full creator management features, use the web dashboard:
  1. Browse Creators: Navigate to /creators in the web app
  2. Search & Filter: Use the advanced search and filtering options
  3. View Details: Click on any creator to see full profile and metrics
  4. Export Data: Use the export button to download creator data

Database Commands

Query creators using SQL commands

Analytics Dashboard

Web interface for creator management

API Reference

Programmatic access to creator data

Creator Discovery

Automated creator discovery features

​
Implementation Status

Track the implementation of creator CLI commands in the GitHub repository. Priority features:
  • Basic CRUD operations
  • Search and filtering
  • Bulk sync operations
  • Export functionality
  • Analytics commands

​
Contributing

Contributions are welcome! The creator commands would be implemented in: 
app/cli/commands/creators/
├── list.ts
├── view.ts
├── sync.ts
├── export.ts
└── index.ts
See the repository for contribution guidelines and architecture documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us