A powerful TikTok analytics and utility assistant that integrates with your AI workflows to fetch video, user, ad, and creator data directly from the MaxHub API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tiktok-aggregate-scraper
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tiktok-aggregate-scraper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is MaxHub TikTok Data Assistant?
The MaxHub TikTok Data Assistant is a robust technical utility designed to provide seamless access to TikTok's vast ecosystem of content, creator, and market data. Powered by the MaxHub API (aconfig.cn), this integration provides developers, marketers, and AI workflows with real-time analytics covering video metrics, user profiles, trending hashtags, ads performance, and e-commerce shop data. By integrating this skill with your AI agents via Openclaw Skills, you can automate complex content analysis and run high-throughput operations directly within your development environment.
Built with strict security and compliance standards, the skill operates primarily in read-only mode to fetch public data safely. It also features protocol utilities for request generation and anti-fraud tools like fake view detection. Whether you are running single queries or orchestrating deep multi-endpoint comparisons, this tool delivers structured and actionable social intelligence to fuel your global marketing efforts.
MaxHub TikTok Data Assistant Use Cases
- Cross-Border Marketing & Product Selection: Discover high-potential trending products on TikTok across various global regions, analyze hot selling lists, and assess target market consumer preferences.
- Influencer Collaboration Evaluation: Quantitatively evaluate TikTok creator metrics, follower demographics, video engagement rates, and historical ad performance before committing to marketing campaigns.
- Multi-Region Content Trend Comparison: Generate regional reports comparing content trends and engagement differentials between the US, Japan, Southeast Asia, and other international markets to guide localized content strategy.
- Anti-Fraud Audience Analysis: Detect inauthentic interactions and fake views on targeted content using data-driven anti-fraud tools to ensure optimal ROI on marketing spends.
How MaxHub TikTok Data Assistant Works
- Environment & API Verification: The agent checks for the presence of the
MAXHUB_API_KEYcredential to ensure authorized connectivity. - Intent Classification: Based on the user's natural language input, the agent classifies the request into core intent groups such as Video, User, Search, Ads, Creator & Shop, or Protocol Tools.
- Reference Mapping: The skill loads the corresponding platform reference files dynamically to locate active endpoints (e.g.,
api-video.mdorapi-search.md) without relying on guessed URLs. - Action Mode Determination: The request is routed into Browse (single query), Analyze (structured trends), or Compare (side-by-side matrices) action modes.
- Parallel Execution & Resilience: The agent executes the necessary endpoints. If a 404 or 500 error is encountered, the skill triggers automated interface degradation to fallback endpoints.
- Localization & Formatting: The structured JSON response is formatted, translating numbers to human-readable scales (like 'K/M/B' for English or '万/亿' for Chinese) and stripping out unwanted HTML tags.
MaxHub TikTok Data Assistant Setup
To configure this skill within your workspace, ensure you have the required curl binary and a valid API key from Aconfig.
Set your API key using your preferred agent framework:
# If using ClawHub/OpenClaw configuration
openclaw config set skills.entries.maxhub-tiktok.apiKey "YOUR_MAXHUB_API_KEY"
# Or configure via environment variables
export MAXHUB_API_KEY="YOUR_MAXHUB_API_KEY"
Verify that the environment variable is loaded successfully before running operations:
[ -n "${MAXHUB_API_KEY:-}" ] && echo "Verification OK" || echo "Key is Missing"
MaxHub TikTok Data Assistant Data Schema & Taxonomy
The skill maps API endpoints to a structured data model to parse data points cleanly. Below is the categorization schema for the key endpoints mapped within Openclaw Skills:
| Module | Key Endpoints | Primary Purpose |
|---|---|---|
| Video & Content | fetch_one_video, fetch_video_comments, detect_fake_views |
Retrieve engagement metrics, comments, and execute anti-fraud verification |
| User Profiles | fetch_user_profile, fetch_user_fans, fetch_user_follow |
Profile scraping, follower count, and community interaction details |
| Ads & Analytics | search_creators, get_ad_interactive_analysis, search_ads |
Track marketing performance, analyze keyframe actions, and filter trending creators |
| E-Commerce & Shops | fetch_product_detail, fetch_shop_info, fetch_hot_selling_products_list |
Extract product descriptions, shop reviews, and e-commerce listings |
| Cryptographic Tools | generate_xbogus, generate_ttwid, register_device |
Access compatibility utilities required by upstream platform protocols |
MaxHub TikTok Data Assistant Advanced Features
- Dynamic Interface Degradation: Robust 404/500/410 error-handling protocol that automatically fallbacks to legacy endpoint versions (e.g., fallback from
fetch_one_video_v3tov2orv1) without breaking agent runtime pipelines. - Multi-Endpoint Orchestration: Capability to run complex, multi-layered patterns such as analyzing an influencer by daisy-chaining creator search, profile retrieval, post collection, and final performance evaluation.
- Platform Compatibility Utilities: Native cryptographic helper endpoints for request formatting (like generating signature signatures and cookies) to ensure high compatibility with upstream servers.
- Intelligent Pagination & Action Handling: Smooth contextual query support allowing natural requests like 'next page' or 'compare with account X' with immediate parameters offset updates.
SKILL.md
Loading
Related Openclaw Skills
MaxHub Jinri Toutiao Data Assistant
A specialized AI agent skill for querying and analyzing Jinri Toutiao articles, videos, user metrics, and comments via the MaxHub API.
SkillAlchemy
SkillAlchemy is an orchestration skill for AI coding agents that analyzes user ideas and orchestrates sub-agents to compile ready-to-use skill files.
Context Scope Discipline
A strict context-budgeting discipline that limits an AI coding agent's writable workspace to 25k tokens, optimizing precision by separating read-only reference material from editable target files.
AI Agent Conventions Pinning SOP
An actionable SOP for writing, loading, and evolving project-level AI convention files so coder agents strictly respect your team's coding standards across tools.
MaxHub Sora2 Data Assistant
An advanced, read-only AI data assistant for querying Sora2 video platform metadata, including post details, user analytics, and Cameo leaderboards.
MaxHub Temp Mail Assistant
A powerful addition to the catalog of Openclaw Skills, enabling secure temporary email lifecycle management and automated inbox verification directly via AI agent commands.
Featured*
