- name
- x-search-highlights
- description
- Search and extract high-value posts from X (Twitter) with engagement-based ranking. Use when user asks to search X, find best posts, get highlights from Twitter/X, or extract high-engagement content on a specific topic.
X Search Highlights
Search and extract high-value posts from X (Twitter) with engagement-based ranking.
Quick Start
# Basic search
~/.openclaw/skills/x-search-highlights/scripts/x-search.sh "Claude Code"
# With filters
~/.openclaw/skills/x-search-highlights/scripts/x-search.sh "AI Agent" 10 5 1000 markdownDescription
Extract valuable posts from X search results based on engagement metrics (likes, retweets, replies, views). Ideal for discovering trending discussions, finding expert insights, or curating content for research.
When to Use
Activate when user asks to:
- Search X/Twitter for specific topics
- Find "best" or "high-value" posts on a subject
- Extract posts with engagement data
- Curate content from X discussions
- Discover trending discussions
Trigger phrases:
- "Search X for [topic]"
- "Find best posts about [topic] on Twitter"
- "Get highlights from X search"
- "Extract valuable tweets"
Input Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
topic | string | required | Search query (e.g., "Claude Code", "AI Agent") |
maxResults | number | 5 | Maximum number of posts to return |
minLikes | number | 0 | Minimum likes threshold (filter low-engagement) |
scrollTimes | number | 3 | Number of scroll iterations (more = more candidates) |
sortBy | string | "engagement" | Sort method: engagement, likes, views, recent |
outputFormat | string | "markdown" | Output format: markdown, json, summary |
Output Format
Markdown (default)
## 1. [Post Title/Summary]
- **标题**：[Content summary]
- **日期**：YYYY-MM-DD
- **标签**：#tag1 #tag2
- **亮点**：🎯 [Key insight] 💡 [Unique perspective]
- **互动**：X 回复 · X 转发 · X 点赞 · X 浏览
- **链接**：[点击阅读原文](URL)JSON
{
"total": 10,
"posts": [
{
"text": "...",
"author": "...",
"likes": 1000,
"retweets": 200,
"views": 50000
}
]
}Workflow
- Open search page: Navigate to X search with query
- Load content: Scroll N times to collect candidate posts
- Extract data: Parse DOM for post content and engagement metrics
- Rank and filter: Calculate engagement scores, apply filters
- Format output: Return results in requested format
Core Algorithm
Engagement Score:
Score = (likes × 2) + (retweets × 5) + (views × 0.01)Weight Rationale:
- Retweets (×5): Strongest signal (public sharing)
- Likes (×2): Approval signal (low barrier)
- Views (×0.01): Reach indicator (easily inflated)
Dependencies
bb-browser≥ 0.11.2- Chrome/Chromium browser
- X.com login state (in bb-browser profile)
Installation
# Via ClawHub (after publishing)
clawhub install x-search-highlights
# Or clone from GitHub
git clone https://github.com/Ghostwritten/x-search-highlights.git ~/.openclaw/skills/x-search-highlightsUsage Examples
# Search for "OpenClaw"
scripts/x-search.sh "OpenClaw"
# Get 10 posts with min 1000 likes
scripts/x-search.sh "AI Agent" 10 3 1000
# JSON output
scripts/x-search.sh "RAG" 20 5 0 jsonTroubleshooting
No posts found:
- Check bb-browser is running:
bb-browser status - Verify X.com login state
- Try different search keywords
JSON parsing errors:
- Ensure
bb-browserversion ≥ 0.11.2 - Check Chrome/Chromium is accessible
Rate limits:
- Reduce
scrollTimesparameter - Add delays between operations
Limitations
- X lazy loading limits initial results
- Bookmark data not available via scraping
- Rate limits may affect large-scale scraping
- Search quality depends on X algorithm