An advanced data assistant skill for querying and analyzing Kuaishou videos, users, live streams, and trends via the MaxHub API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kuaishou-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 kuaishou-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 Kuaishou Data Assistant?
The MaxHub Kuaishou Data Assistant is a powerful read-only data query tool designed for marketing professionals, content creators, and developers seeking deep insights into the Kuaishou platform. By integrating with the MaxHub API platform, this skill allows AI agents to effortlessly fetch real-time metrics across both App and Web interfaces, including video metadata, user followers, search suggestions, hot lists, and comment hierarchies. It functions as a robust choice among Openclaw Skills for automated social listening and content optimization.
Built with developer-friendly specifications, the skill guarantees compliance and safety, operating on a strictly read-only basis without unauthorized account actions. The assistant also incorporates an active error handling and API fallback mechanism to ensure maximum uptime, adapting to upstream protocol changes on the fly. Whether analyzing local market trends or tracking competitive creator performance, this skill automates Kuaishou data extraction directly within your terminal or agent pipeline.
MaxHub Kuaishou Data Assistant Use Cases
- Kuaishou Content Trend Analysis: Marketing teams can fetch hot lists and trending videos to analyze user engagement, visual themes, and viral patterns on the Kuaishou platform.
- Creator & Audience Demographics: Extract detailed creator profile metrics, follower counts, and interaction rates to conduct target audience research in tier-3 and tier-4 Chinese cities.
- Competitive Benchmarking: Perform side-by-side comparisons of multiple creators or video campaigns to understand core differentiators in engagement metrics.
- Interactive Social Listening: Monitor video comments and sub-comments to capture sentiment, common complaints, or popular keywords associated with brand names or products.
How MaxHub Kuaishou Data Assistant Works
- API Key Authorization: The agent first checks for the presence of the
MAXHUB_API_KEYenvironment variable. If missing, it provides a guided setup experience. - Intent & Complexity Classification: User requests are analyzed and routed to specific reference endpoints (e.g., video data, user profiles, trending statistics, live tools) based on trigger keywords.
- Action Mode Identification: The skill determines the optimal delivery mode—Browse (concise single query), Analyze (structured reports and key findings), or Compare (side-by-side matrices).
- Execution and Orchestration: The assistant executes requests via curl, dynamically managing pagination cursors and coordinating multi-endpoint queries in parallel.
- API Version Fallback: If an endpoint returns a 404 or 500 error, the agent automatically downgrades to alternative endpoint versions (e.g., v3 to v2) without failing the execution.
- Result Formatting: Outputs are sanitized (HTML tags removed), numbers humanized (e.g., K/M/B for English, 万/亿 for Chinese), and presented with actionable contextual follow-up steps.
MaxHub Kuaishou Data Assistant Setup
Ensure you have the required binary dependencies and API credentials set up correctly. This skill requires curl and a valid API key from MaxHub.
1. Obtain your API Key
Sign up and generate a key at https://www.aconfig.cn
2. Configure Environment Variables
You can set the credentials globally or specifically for your instance of Openclaw Skills.
Using the Openclaw configuration CLI:
openclaw config set skills.entries.maxhub-kuaishou.apiKey "YOUR_MAXHUB_API_KEY"
Or export the environment variable manually:
export MAXHUB_API_KEY="YOUR_MAXHUB_API_KEY"
3. Verify Connection
Verify your setup by checking the environment variable status:
[ -n "${MAXHUB_API_KEY:-}" ] && echo "ok" || echo "missing"
MaxHub Kuaishou Data Assistant Data Schema & Taxonomy
The skill interacts directly with the MaxHub downstream API endpoints at https://www.aconfig.cn. The structured response utilizes standard JSON formats mapping out content, audience, and search trends.
Core Endpoint References
| Domain | Reference Document | Primary Action | Key Endpoints |
|---|---|---|---|
| Video & Content | references/api-video.md |
Single/batch query, comment scraping | fetch_videos_batch, fetch_one_video_by_url, search_comprehensive |
| User Profiles | references/api-user.md |
ID resolution, stats, follow lists | fetch_get_user_id, fetch_user_info |
| Trending Boards | references/api-trending.md |
Hot search list, board rankings | fetch_kuaishou_hot_list_v1 |
| Live Stream & Tools | references/api-live-tools.md |
Live session metrics, sharing links | Various utility tools |
Endpoint Fallback Mapping
| Initial Endpoint | Fallback Option | Method | Path |
|---|---|---|---|
fetch_one_video_v3 |
fetch_one_video_v2 |
GET | /api/v1/douyin/app/v3/fetch_one_video_v2 |
fetch_one_video_v2 |
fetch_one_video |
GET | /api/v1/douyin/app/v3/fetch_one_video |
fetch_general_search_v1 |
fetch_general_search_v2 |
POST | /api/v1/douyin/search/fetch_general_search_v2 |
handler_user_profile_v4 |
handler_user_profile_v3 |
GET | /api/v1/douyin/app/v3/handler_user_profile_v3 |
MaxHub Kuaishou Data Assistant Advanced Features
- Multi-Version Fallback Engine: Automatically retries alternative API versions if the primary endpoint encounters 404, 410, or 500 responses, maintaining maximum tool reliability.
- Anti-Fraud Detection Analytics: Integrates
detect_fake_viewsprotocols to assess engagement authenticity, helping users analyze inorganic follower spikes and artificial likes. - Humanized Multilingual Output: Automatically converts numerical representations (e.g., 120M vs 1.2亿) and response styles depending on the language context, optimized for standard Openclaw Skills integration.
- Multi-Endpoint Parallel Execution: Coordinates nested workflow paths such as mapping user IDs to complete posting histories and comment arrays in a single automated flow.
- Strict Read-Only Guarantee: Compliant with upstream data usage policies; does not perform mutations, write events, or require user-account credentials.
SKILL.md
Loading
Related Openclaw Skills
AI Agent Development Guide
An advanced knowledge-base and skill workflow mapping full-stack AI agent development practices compiled from top engineering case studies and frameworks.
Agent Builder (RPG Tileset & Art History)
A multi-faceted AI agent skill combining RPG Maker MZ/MV pixel art tileset creation tools with comprehensive, bilingual AP Art History educational resources.
AI Testing & API Proxy Integration Guide
A developer-oriented guide skill for automating and executing AI testing methodologies alongside cost-effective multi-model API proxy workflows.
AI Programming Skill Guide (ai编程-0b1387)
An automated educational skill guide for AI agent workflows that synthesizes expert programming videos, MIT coursework, and industry insights in the AI era.
MaxHub Douyin Data Assistant
An enterprise-grade AI skill providing real-time data access to Douyin analytics, creator profiles, trending topics, live room metrics, and Xingtu influencer marketing data through the MaxHub API.
News Based Stock Research Skill
An educational AI agent skill designed to parse public market news, extract key catalysts, and structure balanced stock watchlists or paper-trading research notes.
Featured*
