# Send Production-ready Twitter/X data and automation for autonomous agents to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "asia-twitter-api-v1", "name": "Production-ready Twitter/X data and automation for autonomous agents", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/renning22/asia-twitter-api-v1", "canonicalUrl": "https://clawhub.ai/renning22/asia-twitter-api-v1", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/asia-twitter-api-v1", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=asia-twitter-api-v1", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "PACKAGE_HYGIENE.md", "NON_TEXT_FILES_REMOVAL.md", "SKILL.md", "README.md", "QUICK_REFERENCE.md", "SECURITY_IMPROVEMENTS.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/asia-twitter-api-v1" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/asia-twitter-api-v1", "downloadUrl": "https://openagent3.xyz/downloads/asia-twitter-api-v1", "agentUrl": "https://openagent3.xyz/skills/asia-twitter-api-v1/agent", "manifestUrl": "https://openagent3.xyz/skills/asia-twitter-api-v1/agent.json", "briefUrl": "https://openagent3.xyz/skills/asia-twitter-api-v1/agent.md" } } ``` ## Documentation ### OpenClaw Twitter 🐦 Twitter/X data access and automation for autonomous agents. Powered by AIsa. One API key. Full Twitter intelligence. ### ⚠️ IMPORTANT SECURITY NOTICE This skill provides two types of operations: ### ✅ Read Operations (SAFE - Recommended for Most Users) User profiles, tweets, search, trends, followers No authentication required No credentials transmitted Safe for production use ### ⚠️ Write Operations (HIGH RISK - Use Only with Dedicated Accounts) Posting, liking, retweeting Requires transmitting email + password + proxy to third-party API Security Risk: Full account access granted to api.aisa.one ⚠️ CRITICAL: Never use write operations with your primary Twitter account. Create dedicated automation accounts only. ### Monitor Influencers "Get Elon Musk's latest tweets and notify me of any AI-related posts" ### Track Trends "What's trending on Twitter worldwide right now?" ### Social Listening "Search for tweets mentioning our product and analyze sentiment" ### Competitor Intelligence "Monitor @anthropic and @GoogleAI - alert me on new announcements" ### User Research "Find AI researchers in the Bay Area and show their recent work" ### Quick Start export AISA_API_KEY="your-key" Get your API key at aisa.one ### ✅ Read Operations (No Login Required - Safe) All read operations are safe and require only your AIsa API key. No Twitter credentials needed. Get User Information curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \\ -H "Authorization: Bearer $AISA_API_KEY" Get User's Latest Tweets curl "https://api.aisa.one/apis/v1/twitter/user/user_last_tweet?userName=elonmusk" \\ -H "Authorization: Bearer $AISA_API_KEY" Search Tweets (Advanced) Important: queryType parameter is required (Latest or Top) # Search latest tweets curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \\ -H "Authorization: Bearer $AISA_API_KEY" # Search top tweets curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \\ -H "Authorization: Bearer $AISA_API_KEY" Get Trending Topics # Worldwide trends (woeid=1) curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \\ -H "Authorization: Bearer $AISA_API_KEY" Search Users curl "https://api.aisa.one/apis/v1/twitter/user/search_user?keyword=AI+researcher" \\ -H "Authorization: Bearer $AISA_API_KEY" Get Tweet Details by ID curl "https://api.aisa.one/apis/v1/twitter/tweet/tweetById?tweet_ids=123456789" \\ -H "Authorization: Bearer $AISA_API_KEY" Get User Followers curl "https://api.aisa.one/apis/v1/twitter/user/user_followers?userName=elonmusk" \\ -H "Authorization: Bearer $AISA_API_KEY" Get User Followings curl "https://api.aisa.one/apis/v1/twitter/user/user_followings?userName=elonmusk" \\ -H "Authorization: Bearer $AISA_API_KEY" ### ⚠️ Write Operations (High Risk - Requires Authentication) 🚨 CRITICAL SECURITY WARNING Write operations require you to: Send your Twitter email, password, and proxy credentials to api.aisa.one Trust a third-party service with full account access Accept responsibility for account security NEVER use these operations with: ❌ Your primary Twitter account ❌ Accounts with sensitive data ❌ Verified or high-value accounts ❌ Accounts you cannot afford to lose ONLY use with: ✅ Dedicated test/automation accounts ✅ Unique passwords not used elsewhere ✅ Accounts created specifically for this purpose ✅ After reviewing AIsa's security policies You acknowledge and accept all risks by using write operations. ### Write Operations API Reference ⚠️ Warning: All write operations require prior authentication via login endpoint. Step 1: Account Login (Async Operation) curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \\ -H "Authorization: Bearer $AISA_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "user_name": "test_automation_account", "email": "test@example.com", "password": "unique_password_here", "proxy": "http://user:pass@proxy-ip:port" }' Login is asynchronous - check status after submission. Step 2: Check Login Status curl "https://api.aisa.one/apis/v1/twitter/get_my_x_account_detail_v3?user_name=test_automation_account" \\ -H "Authorization: Bearer $AISA_API_KEY" Post a Tweet curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \\ -H "Authorization: Bearer $AISA_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "user_name": "test_automation_account", "text": "Hello from OpenClaw!" }' Like a Tweet curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \\ -H "Authorization: Bearer $AISA_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "user_name": "test_automation_account", "tweet_id": "1234567890" }' Retweet curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_v3" \\ -H "Authorization: Bearer $AISA_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "user_name": "test_automation_account", "tweet_id": "1234567890" }' Update Profile curl -X POST "https://api.aisa.one/apis/v1/twitter/update_profile_v3" \\ -H "Authorization: Bearer $AISA_API_KEY" \\ -H "Content-Type: application/json" \\ -d '{ "user_name": "test_automation_account", "name": "New Name", "bio": "New bio" }' ### Safe Read Operations # User operations (safe) python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk # Search & Discovery (safe) python3 {baseDir}/scripts/twitter_client.py search --query "AI agents" python3 {baseDir}/scripts/twitter_client.py user-search --keyword "AI researcher" python3 {baseDir}/scripts/twitter_client.py trends --woeid 1 ### ⚠️ Write Operations (High Risk) Only use with dedicated test accounts: # Login (use test account only!) python3 {baseDir}/scripts/twitter_client.py login \\ --username test_automation_account \\ --email test@example.com \\ --password unique_password \\ --proxy "http://user:pass@ip:port" # Check account status python3 {baseDir}/scripts/twitter_client.py account --username test_automation_account # Post operations (after login) python3 {baseDir}/scripts/twitter_client.py post \\ --username test_automation_account \\ --text "Test post" python3 {baseDir}/scripts/twitter_client.py like \\ --username test_automation_account \\ --tweet-id 1234567890 python3 {baseDir}/scripts/twitter_client.py retweet \\ --username test_automation_account \\ --tweet-id 1234567890 ### Read Operations (Safe) EndpointMethodDescription/twitter/user/infoGETGet user profile/twitter/user/user_last_tweetGETGet user's recent tweets/twitter/user/user_followersGETGet user followers/twitter/user/user_followingsGETGet user followings/twitter/user/search_userGETSearch users by keyword/twitter/tweet/advanced_searchGETAdvanced tweet search/twitter/tweet/tweetByIdGETGet tweets by IDs/twitter/trendsGETGet trending topics ### Write Operations (⚠️ High Risk) EndpointMethodDescription/twitter/user_login_v3POSTLogin to account ⚠️/twitter/send_tweet_v3POSTSend a tweet ⚠️/twitter/like_tweet_v3POSTLike a tweet ⚠️/twitter/retweet_v3POSTRetweet ⚠️ ### Pricing OperationCost per RequestRead operations~$0.0004Write operations~$0.001 Every API response includes usage.cost and usage.credits_remaining fields. ### Step 1: Get API Key Sign up at aisa.one and obtain your API key. ### Step 2: Add Credits AIsa uses pay-as-you-go pricing. Add credits to your account. ### Step 3: Set Environment Variable export AISA_API_KEY="your-key-here" ### Step 4: Start with Read Operations Begin with safe read operations to familiarize yourself with the API. Only proceed to write operations if you have a specific need and dedicated test account. ### Security Best Practices Default to read-only - Most use cases don't need write access Separate accounts - Never mix automation with personal accounts Unique credentials - Use unique passwords for automation accounts Environment variables - Never hardcode credentials in scripts Monitor activity - Regularly check your AIsa dashboard Rotate keys - Periodically rotate API keys Minimal permissions - Only use write operations when absolutely necessary Test thoroughly - Always test with test accounts first Review ToS - Understand both Twitter and AIsa terms of service Have a backup plan - Be prepared for account suspension ### Documentation Full API Reference AIsa Security Policies OpenClaw Documentation ClawHub Package ### Support API Issues: Contact AIsa support at aisa.one Skill Issues: Open issue on GitHub Security Concerns: Review AIsa security documentation ### Disclaimer This skill facilitates access to Twitter data through AIsa's API. Write operations require transmitting credentials to a third-party service. Users assume all responsibility and risk. The authors and AIsa are not liable for account suspension, data loss, or security breaches. Use at your own risk. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: renning22 - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/asia-twitter-api-v1) - [Send to Agent page](https://openagent3.xyz/skills/asia-twitter-api-v1/agent) - [JSON manifest](https://openagent3.xyz/skills/asia-twitter-api-v1/agent.json) - [Markdown brief](https://openagent3.xyz/skills/asia-twitter-api-v1/agent.md) - [Download page](https://openagent3.xyz/downloads/asia-twitter-api-v1)