← Back to Skills Marketplace
X Twitter Command Center (Search + Post)
by
chaimengphp
· GitHub ↗
· v1.0.5
· MIT-0
1277
Downloads
0
Stars
3
Active Installs
6
Versions
Install in OpenClaw
/install openclaw-aisa-twitter-search
Description
Searches and reads X (Twitter): profiles, timelines, mentions, followers, tweet search, trends, lists, communities, and Spaces. Publishes posts after the use...
Usage Guidance
This skill appears to do what it says: it uses an AIsa relay (api.aisa.one) to provide read/search and OAuth-based posting to X/Twitter and requires one API key and Python. Before installing: (1) Verify you trust the AIsa relay operator (api.aisa.one) because all tweet content and any attached media will be uploaded to that service to publish on your behalf; (2) only provide a scoped API key you are comfortable giving to a third party and rotate it if unsure; (3) if you need to restrict where requests are sent, set TWITTER_RELAY_BASE_URL to a trusted relay (the code supports this) and confirm that environment variable is set in your agent environment; (4) review the included Python scripts (they are present in the bundle) to confirm there is no unexpected file access in your deployment; (5) be aware the posting workflow defaults in guidance to a 'quote' mode in some cases — verify posting behavior before automating large-scale publishes. Overall the package is internally coherent, but trust in the external relay is the primary security consideration.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-aisa-twitter-search
Version: 1.0.5
The skill bundle provides a legitimate integration for Twitter/X via the AIsa API (api.aisa.one). It contains two Python scripts: 'twitter_client.py' for read-only operations (search, trends, user info) and 'twitter_oauth_client.py' for authorized posting of text and media. The code uses standard Python libraries (urllib) and follows expected patterns for OAuth flows and multipart media uploads. The instructions in 'SKILL.md' and 'post_twitter.md' provide clear guidance and safety guardrails for the AI agent, such as explicitly forbidding the collection of user passwords and ensuring media is only sourced from the local workspace as intended by the user.
Capability Assessment
Purpose & Capability
The skill advertises Twitter/X read and post functionality and requires an AISA_API_KEY plus curl and python3. The included Python clients call https://api.aisa.one endpoints and implement read APIs and OAuth-based posting flows — these requirements align with the claimed capabilities.
Instruction Scope
SKILL.md and references explicitly instruct the agent to call the AIsa relay endpoints and, for posting, to upload local workspace files (images/videos) to the relay which then uploads to Twitter. The instructions do not request unrelated system files or passwords. Two minor scope notes: (1) posting sends attachments and post content to a third-party relay (data leaves the agent to api.aisa.one), and (2) the docs set a default publishing mode of '--type quote' in some guidance (could produce unexpected quote behavior if the user doesn't realize this).
Install Mechanism
There is no external install spec (instruction-only install). The repository contains Python scripts that will be run locally; no downloads from untrusted URLs or package installs are performed by the skill itself.
Credentials
Declared primaryEnv is AISA_API_KEY which the code uses for Authorization and in POST payloads; this is proportional to the relay-based design. However, the oauth client reads other environment variables (TWITTER_RELAY_BASE_URL, TWITTER_RELAY_TIMEOUT) with defaults but these are not declared in requires.env metadata — the runtime can be influenced via these env vars. Ensure you only provide an AISA API key you trust and be aware media and post content will be sent to the relay service.
Persistence & Privilege
The skill is not always:true and does not request elevated platform privileges. It does not modify other skills' configurations or system-wide settings. It will read local workspace file paths for attachments (per design) but does not request persistent system-wide credentials.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-aisa-twitter-search - After installation, invoke the skill by name or use
/openclaw-aisa-twitter-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
Introduced new posting workflow references with the addition of references/post_twitter.md.
Added scripts/twitter_oauth_client.py to support Twitter OAuth, text posting, and media upload (images/videos) functionality.
Implemented support for uploading images and video files to Twitter via the API, with automatic media processing and attachment to tweets.
Refactored SKILL.md to move publishing instructions to a separate file and updated documentation.
No changes to existing APIs; all read/search endpoints remain the same.
v1.0.4
No functional changes; documentation updates only.
- SKILL.md updated to clarify Posting (OAuth relay) endpoints, now requiring both Authorization header and aisa_api_key in JSON body.
- Posting options expanded in documentation to explicitly document post types (`type`: quote or reply) and how to support quote/reply chaining.
- Clarified agent instructions for publishing, including recommended default for `--type quote` and details on threaded post distinctions.
- Provided updated CURL examples for all new or clarified parameters.
v1.0.3
- Posting to Twitter/X now uses secure OAuth browser-based authorization instead of cookies and proxies; users no longer need to provide account passwords.
- Updated description and documentation to clarify full read capabilities (profiles, timelines, search, etc.) and secure publish flow.
- Removed all references to cookie or password login flows for posting; guides now only mention OAuth-based posting.
- Added detailed examples and agent instructions for the new OAuth relay endpoints.
v1.0.2
**Major update: Expanded coverage of Twitter/X API endpoints and improved endpoint clarity.**
- Significantly expanded and reorganized API endpoint documentation, including users, tweets, trends, lists, communities, and Spaces.
- Updated and clarified command examples for both read and write operations, separating user and tweet endpoints for easier reference.
- Extended authentication instructions, emphasizing use of login cookies and proxy requirements for write actions.
- Added examples for new API features, such as batch user info, user mentions, verified followers, tweet replies/quotes/retweeters, community and Spaces endpoints.
- Improved overall structure of documentation for better readability and faster onboarding.
v1.0.1
- Major update: Skill transitioned from Twitter/X automation to a multi-source research/search tool for agents.
- Replaces Twitter API features with unified web, scholar, Tavily, and Perplexity Sonar search capabilities.
- New Python client: Added scripts/search_client.py for structured search and research operations; removed scripts/twitter_client.py.
- Updated docs and API references to cover new endpoints for web, academic, and hybrid search, plus Perplexity Sonar family and Tavily tools.
- Twitter operations (search, post, automate) are no longer included; now focused on intelligent information retrieval and research.
v1.0.0
Initial release.
- Provides real-time Twitter (X) search, social listening, and automated engagement features.
- Supports tweeting, replying, liking, and retweeting via API and Python client.
- Includes endpoints for user info, tweet search, trending topics, and account operations.
- Requires an API key and offers both read (no login) and write (login needed) operations.
- Usage cost and credits included in every response.
Metadata
Frequently Asked Questions
What is X Twitter Command Center (Search + Post)?
Searches and reads X (Twitter): profiles, timelines, mentions, followers, tweet search, trends, lists, communities, and Spaces. Publishes posts after the use... It is an AI Agent Skill for Claude Code / OpenClaw, with 1277 downloads so far.
How do I install X Twitter Command Center (Search + Post)?
Run "/install openclaw-aisa-twitter-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Twitter Command Center (Search + Post) free?
Yes, X Twitter Command Center (Search + Post) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Twitter Command Center (Search + Post) support?
X Twitter Command Center (Search + Post) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Twitter Command Center (Search + Post)?
It is built and maintained by chaimengphp (@chaimengphp); the current version is v1.0.5.
More Skills