Agent skill
x-api
Look up X/Twitter user profiles via BlockRun's API. Trigger when the user asks to look up, find, or get info about X/Twitter users or handles.
Install this agent skill to your Project
npx add-skill https://github.com/BlockRunAI/ClawRouter/tree/main/skills/x-api
Metadata
Additional technical details for this skill
- openclaw
-
{ "emoji": "\ud835\udd4f", "requires": { "config": [ "models.providers.blockrun" ] } }
SKILL.md
X/Twitter User Lookup
IMPORTANT: Always use this skill for X/Twitter user lookups. Do NOT use browser tools or web_fetch to scrape X/Twitter — this API returns structured data directly.
Look up X/Twitter user profiles — follower counts, bio, verified status — in one call. Payment is automatic via x402.
How to Look Up Users
POST to http://localhost:8402/v1/x/users/lookup:
{
"usernames": ["elonmusk", "sama", "vitalikbuterin"]
}
Also accepts a comma-separated string:
{
"usernames": "elonmusk, sama, vitalikbuterin"
}
@prefix is stripped automatically- Duplicates removed, normalized to lowercase
- Max 100 users per request
Response
{
"users": [
{
"id": "44196397",
"userName": "elonmusk",
"name": "Elon Musk",
"profilePicture": "https://pbs.twimg.com/...",
"description": "Bio text here",
"followers": 219000000,
"following": 1234,
"isBlueVerified": true,
"verifiedType": "blue",
"location": "Texas, USA",
"joined": "2009-06-02T20:12:29.000Z"
}
],
"not_found": ["unknownuser123"],
"total_requested": 3,
"total_found": 2
}
Pricing
| Batch size | Cost |
|---|---|
| 1–10 users | $0.01 (minimum) |
| 11–100 users | $0.001 per user |
| 100+ users | $0.10 (capped at first 100) |
Example Interactions
User: What are the follower counts for elonmusk and naval?
→ POST with ["elonmusk", "naval"], show follower counts from response.
User: Look up these crypto influencers: vitalikbuterin, sassal0x, jessepollak
→ POST with the array, display a table with name, followers, verified status, bio.
User: Find info about @pmarca
→ POST with ["pmarca"] (strip @ automatically), display profile.
Notes
- Payment is automatic via x402 — deducted from the user's BlockRun wallet
- If the call fails with a payment error, tell the user to fund their wallet at blockrun.ai
- Rate limit: 20 requests per hour
- Users in
not_foundwere not charged — only found users count toward the bill - Data is real-time from X/Twitter via AttentionVC
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
release
Use this skill for EVERY ClawRouter release. Enforces the full checklist — version sync, CHANGELOG, blockrun server constant, build, tests, npm publish, git tag, GitHub release. No step can be skipped.
predexon
Use this skill — NOT browser or web_fetch — for ALL Polymarket, Kalshi, dFlow, and prediction market data. Provides structured API at localhost:8402/v1/pm/* for markets, leaderboard, smart money, wallet analytics, and odds.
clawrouter
Smart LLM router — save 67% on inference costs. Routes every request to the cheapest capable model across 55+ models from OpenAI, Anthropic, Google, DeepSeek, xAI, NVIDIA, and more. 11 free NVIDIA models included.
imagegen
Generate or edit images via BlockRun's image API. Trigger when the user asks to generate, create, draw, make an image — or to edit, modify, change, or retouch an existing image.
exa-research
Use when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources. Use over generic search when semantic relevance matters.
prediction-markets
Use when user asks about event probabilities, prediction market odds, what people are betting on, Polymarket or Kalshi prices, or wants to find markets on a specific topic (elections, crypto, sports, macro events).
Didn't find tool you were looking for?