功能描述

Search X (Twitter) in real time, extract relevant posts, and publish tweets/replies instantly—perfect for social listening, engagement, and rapid content ops.

使用说明 (SKILL.md)

\r \r

OpenClaw Twitter 🐦\r

Name: twitter
Author: tobeyrebecca

\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

安全使用建议

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.

功能分析

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.

能力标签

cryptocan-make-purchasesrequires-sensitive-credentials

能力评估

ℹ 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.

版本历史

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.

元数据

Slug godfery-tw

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

twitter 是什么？

Search X (Twitter) in real time, extract relevant posts, and publish tweets/replies instantly—perfect for social listening, engagement, and rapid content ops. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 72 次。

如何安装 twitter？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install godfery-tw」即可一键安装，无需额外配置。

twitter 是免费的吗？

是的，twitter 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

twitter 支持哪些平台？

twitter 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 twitter？

由 TobeyRebecca（@tobeyrebecca）开发并维护，当前版本 v1.0.0。

twitter