MaxHub Twitter/X Data Assistant for Openclaw

An advanced integration using Openclaw Skills to perform robust, read-only data analysis and trend monitoring on Twitter/X via the MaxHub API.

new-ironman
v3.6.1
Jun 2, 2026
0
516
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install twitter-aggregate-scraper

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install twitter-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 Twitter/X Data Assistant?

The MaxHub Twitter/X Data Assistant is a specialized, read-only analytics integration designed to bring powerful social intelligence capabilities directly to your AI workflow. Developed for seamless integration with Openclaw Skills, this tool acts as a dedicated bridge to the MaxHub data APIs at aconfig.cn. It allows users and agents to query comprehensive Twitter/X data—including full tweet details, user profile stats, follower lists, reply threads, and global trends—without running into the complexity of building custom scrapers.

Operating with a strict read-only compliance posture, the skill executes data requests safely without interacting with account writing features, keeping your workflows completely secure. It acts as an autonomous agent assistant that handles everything from request authorization to automatic pagination, ensuring that you can easily convert social interactions into highly structured datasets and actionable business intelligence.

MaxHub Twitter/X Data Assistant Use Cases

  • Overseas Public Sentiment Monitoring: Monitor brand mentions, track user sentiment propagation, and generate comprehensive public relations risk reports in real time.
  • Hot Topic & Trend Tracking: Extract real-time global trending topics and analyze discussions to adapt marketing copy and news coverage instantaneously.
  • KOL & Influencer Analytics: Analyze influencer follower lists, engagement metrics, and historical posts to assess marketing campaign potential with data-backed accuracy.

How MaxHub Twitter/X Data Assistant Works

  1. API Validation: The skill checks for the presence of the MAXHUB_API_KEY credential in the execution environment.
  2. Complexity Mapping: Categorizes incoming prompts into Simple (single-call endpoints) or Deep (multi-endpoint analytical journeys).
  3. Intent and Mode Classification: Detects user query intentions and assigns the execution path to Browse, Analyze, or Compare mode.
  4. Autonomous Querying: Initiates concurrent or sequential HTTP requests using standard CLI tools like curl to fetch target Twitter/X data safely.
  5. Dynamic Metric Formatting: Formats high numbers naturally based on the detected language (e.g., using K/M/B for English queries, and 万/亿 for Chinese queries).
  6. Adaptive Markdown Reporting: Presents data inside clean, structured Markdown tables, key bullet points, or side-by-side comparison matrixes.

MaxHub Twitter/X Data Assistant Setup

To run this skill, configure the required API key from the MaxHub platform into your Openclaw Skills environment.

Prerequisites

  • curl installed locally
  • A valid MaxHub API Key (obtainable at https://www.aconfig.cn)

Step-by-Step Configuration

Choose one of the following methods to define your credentials:

Method A: Using ClawHub CLI

openclaw config set skills.entries.maxhub-twitter.apiKey "YOUR_MAXHUB_API_KEY"

Method B: Exporting Environment Variables

export MAXHUB_API_KEY="YOUR_MAXHUB_API_KEY"

Connection Verification

Verify that the environment has correctly loaded your credentials:

[ -n "${MAXHUB_API_KEY:-}" ] && echo "Key set successfully" || echo "Key missing"

MaxHub Twitter/X Data Assistant Data Schema & Taxonomy

The skill manages queries across distinct endpoint modules mapped via internal reference files:

Domain Architecture

Data Category Target Reference File Description
Tweet Data references/api-tweet.md Queries specific tweet status metadata, replies, comments, and engagement distributions.
User Data references/api-user.md Retrieves user profile metadata, verified statuses, following details, and followers counts.
Search & Trending references/api-search-trending.md Pulls global trends, custom query search timelines, and topic rankings.

All HTTP endpoints default to standard JSON structures using Authorization: Bearer request headers.

MaxHub Twitter/X Data Assistant Advanced Features

  • Automatic Interface Degradation: Instantly falls back to alternative endpoint versions (e.g., v3 degradation to v2 or v1) if the upstream endpoint undergoes unexpected maintenance or returns 404/500 errors.
  • Deep Dive Multi-Call Orchestration: Seamlessly sequences multiple API interactions back-to-back to generate multi-dimensional brand audits and comprehensive analytics sheets automatically.
  • Smart Error Handling and Retries: Features auto-retries for 502 server errors, clean error messaging, and structured handling of rate limits (429 errors).
  • Safe Compliance Protocols: Employs built-in verification methods such as detect_fake_views to flag bot traffic and artificial engagements programmatically without making state modifications.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*