← Back to Skills Marketplace
twitter
by
TobeyRebecca
· GitHub ↗
· v1.0.0
· MIT-0
72
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install godfery-tw
Description
Search X (Twitter) in real time, extract relevant posts, and publish tweets/replies instantly—perfect for social listening, engagement, and rapid content ops.
README (SKILL.md)
\r \r
OpenClaw Twitter 🐦\r
\r Twitter/X data access and automation for autonomous agents. Powered by SkillBoss API Hub.\r \r One API key. Full Twitter intelligence.\r \r
🔥 What Can You Do?\r
\r
Monitor Influencers\r
"Get Elon Musk's latest tweets and notify me of any AI-related posts"\r
```\r
\r
### Track Trends\r
```\r
"What's trending on Twitter worldwide right now?"\r
```\r
\r
### Social Listening\r
```\r
"Search for tweets mentioning our product and analyze sentiment"\r
```\r
\r
### Automated Engagement\r
```\r
"Like and retweet posts from @OpenAI that mention GPT-5"\r
```\r
\r
### Competitor Intel\r
```\r
"Monitor @anthropic and @GoogleAI - alert me on new announcements"\r
```\r
\r
## Quick Start\r
\r
```bash\r
export SKILLBOSS_API_KEY="your-key"\r
```\r
\r
## Core Capabilities\r
\r
### Read Operations (No Login Required)\r
\r
```bash\r
# Get user info\r
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Get user's latest tweets\r
curl "https://api.aisa.one/apis/v1/twitter/user/user_last_tweet?userName=elonmusk" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Advanced tweet search (queryType is required: Latest or Top)\r
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Search top tweets\r
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Get trending topics (worldwide)\r
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Search users by keyword\r
curl "https://api.aisa.one/apis/v1/twitter/user/search_user?keyword=AI+researcher" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Get tweets by ID\r
curl "https://api.aisa.one/apis/v1/twitter/tweet/tweetById?tweet_ids=123456789" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Get user followers\r
curl "https://api.aisa.one/apis/v1/twitter/user/user_followers?userName=elonmusk" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Get user followings\r
curl "https://api.aisa.one/apis/v1/twitter/user/user_followings?userName=elonmusk" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
```\r
\r
### Write Operations (Requires Login)\r
\r
> ⚠️ **Warning**: Posting requires account login. Use responsibly to avoid rate limits or account suspension.\r
\r
```bash\r
# Step 1: Login first (async, check status after)\r
curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY" \\r
-H "Content-Type: application/json" \\r
-d '{"user_name":"myaccount","email":"[email protected]","password":"xxx","proxy":"http://user:pass@ip:port"}'\r
\r
# Step 2: Check login status\r
curl "https://api.aisa.one/apis/v1/twitter/get_my_x_account_detail_v3?user_name=myaccount" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY"\r
\r
# Send tweet\r
curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY" \\r
-H "Content-Type: application/json" \\r
-d '{"user_name":"myaccount","text":"Hello from OpenClaw!"}'\r
\r
# Like a tweet\r
curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY" \\r
-H "Content-Type: application/json" \\r
-d '{"user_name":"myaccount","tweet_id":"1234567890"}'\r
\r
# Retweet\r
curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_v3" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY" \\r
-H "Content-Type: application/json" \\r
-d '{"user_name":"myaccount","tweet_id":"1234567890"}'\r
\r
# Update profile\r
curl -X POST "https://api.aisa.one/apis/v1/twitter/update_profile_v3" \\r
-H "Authorization: Bearer $SKILLBOSS_API_KEY" \\r
-H "Content-Type: application/json" \\r
-d '{"user_name":"myaccount","name":"New Name","bio":"New bio"}'\r
```\r
\r
## Python Client\r
\r
```bash\r
# User operations\r
python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk\r
python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk\r
python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk\r
python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk\r
\r
# Search & Discovery\r
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents"\r
python3 {baseDir}/scripts/twitter_client.py user-search --keyword "AI researcher"\r
python3 {baseDir}/scripts/twitter_client.py trends --woeid 1\r
\r
# Post operations (requires login)\r
python3 {baseDir}/scripts/twitter_client.py login --username myaccount --email [email protected] --password xxx --proxy "http://user:pass@ip:port"\r
python3 {baseDir}/scripts/twitter_client.py post --username myaccount --text "Hello!"\r
python3 {baseDir}/scripts/twitter_client.py like --username myaccount --tweet-id 1234567890\r
python3 {baseDir}/scripts/twitter_client.py retweet --username myaccount --tweet-id 1234567890\r
```\r
\r
## API Endpoints Reference\r
\r
| Endpoint | Method | Description |\r
|----------|--------|-------------|\r
| `/twitter/user/info` | GET | Get user profile |\r
| `/twitter/user/user_last_tweet` | GET | Get user's recent tweets |\r
| `/twitter/user/user_followers` | GET | Get user followers |\r
| `/twitter/user/user_followings` | GET | Get user followings |\r
| `/twitter/user/search_user` | GET | Search users by keyword |\r
| `/twitter/tweet/advanced_search` | GET | Advanced tweet search |\r
| `/twitter/tweet/tweetById` | GET | Get tweets by IDs |\r
| `/twitter/trends` | GET | Get trending topics |\r
| `/twitter/user_login_v3` | POST | Login to account |\r
| `/twitter/send_tweet_v3` | POST | Send a tweet |\r
| `/twitter/like_tweet_v3` | POST | Like a tweet |\r
| `/twitter/retweet_v3` | POST | Retweet |\r
\r
## Pricing\r
\r
| API | Cost |\r
|-----|------|\r
| Twitter read query | ~$0.0004 |\r
| Twitter post/like/retweet | ~$0.001 |\r
\r
Every response includes `usage.cost` and `usage.credits_remaining`.\r
\r
## Get Started\r
\r
1. Sign up at [skillbossai.com](https://skillbossai.com)\r
2. Get your API key\r
3. Add credits (pay-as-you-go)\r
4. Set environment variable: `export SKILLBOSS_API_KEY="your-key"`\r
\r
## Full API Reference\r
\r
See [API Reference](https://aisa.mintlify.app/api-reference/introduction) for complete endpoint documentation.\r
Usage Guidance
Before installing or using this skill, consider the following: (1) This skill proxies all Twitter/X activity through a third-party service (api.aisa.one / SkillBoss). Only provide your SKILLBOSS_API_KEY if you trust that service. (2) The skill's write operations require supplying your Twitter account email and raw password (and optionally proxy credentials) to that third-party — avoid doing this with your primary account. Prefer OAuth or API-token-based delegation where possible. (3) Passing passwords on the command line can leak via shell history; if you must test, use a disposable account and rotate credentials afterward. (4) If you want to prevent accidental autonomous posting, restrict the agent's ability to invoke the skill or disable autonomous model invocation for flows that perform logins/posts. (5) Verify SkillBoss / aisa.one's privacy and security policies and consider auditing traffic or using an isolated environment before granting any real account credentials.
Capability Analysis
Type: OpenClaw Skill
Name: godfery-tw
Version: 1.0.0
The skill provides a CLI and API wrapper for Twitter automation via the SkillBoss API Hub (api.aisa.one). It is classified as suspicious because it requires users to provide raw Twitter credentials (email and password) as plaintext command-line arguments, which are then transmitted to a third-party service. This design pattern is a significant security vulnerability as it exposes credentials in shell history and process lists, and requires total trust in the third-party endpoint (api.aisa.one) to handle sensitive login data. No evidence of intentional hidden exfiltration or unauthorized system access was found in scripts/twitter_client.py or SKILL.md.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, required binaries (curl, python3), and the declared SKILLBOSS_API_KEY align with the skill's stated Twitter/X search and posting functionality. However, the skill does not use the official Twitter API directly; it proxies requests through a third-party service (api.aisa.one / SkillBoss), which is an important behavior the description doesn't emphasize. Owner/source are unknown, which reduces trust.
Instruction Scope
SKILL.md and the bundled python client instruct the agent/user to perform login operations that send a user's Twitter username, email, and raw password (and an optional proxy with credentials) to https://api.aisa.one endpoints. Transmitting account credentials and proxy credentials to an external aggregator is outside the minimal scope of a simple search/post skill and increases risk of credential exposure or misuse. The instructions also show using CLI args for passwords (which can be recorded in shell history) and provide no guidance about secure handling or storage of these sensitive values.
Install Mechanism
There is no install spec (instruction-only), and the included python script is the only code. No remote downloads or archive extraction are performed by the skill itself, which is low risk from an installation standpoint. The script performs network calls (expected for this functionality).
Credentials
The skill declares a single required env var (SKILLBOSS_API_KEY), which is proportionate for using the SkillBoss API. However, the runtime behavior requires users to provide their Twitter account credentials and potentially proxy credentials (not declared as required env vars). Asking for high-sensitivity items (account password, proxy user:pass) without documenting why OAuth or API tokens can't be used is disproportionate and risky.
Persistence & Privilege
The skill is not 'always' enabled and does not request special installation privileges. Model invocation is allowed (platform default), which means an autonomous agent could log in and post if credentials are provided — a normal platform behavior but one that increases impact because the skill can perform write actions on social accounts.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install godfery-tw - After installation, invoke the skill by name or use
/godfery-tw - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Twitter Command Center for real-time X (Twitter) search, posting, and engagement.
- Supports influencer monitoring, trend tracking, social listening, competitor intel, and automated engagement.
- Provides both read (search, fetch posts/users, trends) and write (tweet, like, retweet, update profile) operations.
- Includes detailed API examples and Python client scripts for easy integration.
- Requires SKILLBOSS_API_KEY for authentication; posting operations require Twitter/X account login.
Metadata
Frequently Asked Questions
What is twitter?
Search X (Twitter) in real time, extract relevant posts, and publish tweets/replies instantly—perfect for social listening, engagement, and rapid content ops. It is an AI Agent Skill for Claude Code / OpenClaw, with 72 downloads so far.
How do I install twitter?
Run "/install godfery-tw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is twitter free?
Yes, twitter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does twitter support?
twitter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created twitter?
It is built and maintained by TobeyRebecca (@tobeyrebecca); the current version is v1.0.0.
More Skills