← Back to Skills Marketplace
90
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install twitter-aisa-api
Description
Search and read Twitter/X profiles, tweets, trends, and Spaces via AISA relay, then publish posts with OAuth and approved media files using AISA_API_KEY.
Usage Guidance
This package is generally coherent with its stated purpose (reads and posts via the AISA relay), but the top-level registry metadata does not list the required AISA_API_KEY or python3 even though SKILL.md and the scripts require them. Before installing or enabling: 1) verify the AISA_API_KEY comes from a trusted AISA operator and that you understand the key's permissions; 2) review the included scripts (twitter_oauth_client.py) for where OAuth tokens are stored or cached (ensure they are not silently written to unexpected locations); 3) be aware that publishing will upload any provided workspace media to https://api.aisa.one (the relay) and that network calls occur; 4) test in a sandboxed environment if possible; and 5) request the publisher to correct registry metadata so required env vars and binaries are declared. If you cannot confirm the relay operator or token handling, do not install or run the skill with real credentials.
Capability Analysis
Type: OpenClaw Skill
Name: twitter-aisa-api
Version: 1.0.1
The skill bundle provides a legitimate interface for interacting with Twitter/X via the AISA relay service (api.aisa.one). The Python scripts (twitter_client.py and twitter_oauth_client.py) use standard libraries to perform API requests and handle OAuth-based posting, including sophisticated logic for Twitter-specific character weighting and media uploads. The instructions in SKILL.md and post_twitter.md are well-aligned with the tool's purpose and include explicit guardrails against malicious patterns such as password/cookie theft or unauthorized browser execution.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's name, description, SKILL.md, and Python clients are coherent: they implement read APIs and OAuth-based posting via the AISA relay (api.aisa.one). Requiring an AISA_API_KEY and python3 is proportionate to the stated capability. However, the registry-level top summary lists no required env vars or bins while SKILL.md and the scripts require AISA_API_KEY and python3 — this packaging/metadata mismatch is unexpected.
Instruction Scope
Runtime instructions in SKILL.md and references/post_twitter.md are scoped to searching, reading, and publishing via the relay. They explicitly require OAuth approval for posting, restrict media uploads to user-provided workspace files, and advise returning an authorization URL rather than collecting passwords or cookies. The scripts only reference workspace file paths for media and the AISA_API_KEY env var.
Install Mechanism
No install spec is provided (instruction-only packaging), and included code files are present in the bundle — nothing is downloaded from external URLs during install. This is low-install risk, but you should verify the included scripts before running.
Credentials
The code and SKILL.md require AISA_API_KEY (and the SKILL.md metadata lists python3). That single API key is proportionate to the skill's purpose. The concern is that the registry metadata at the top of the bundle incorrectly lists no required env vars or primary credential, which could cause accidental omission of required secrets by operators or mask the need to supply the API key. No other unrelated credentials are requested by the code.
Persistence & Privilege
The skill is not forced always-on (always: false) and uses normal autonomous invocation. SKILL.md claims no home-directory persistence or cookie scraping; the provided code appears to follow a relay/OAuth flow. You should still verify whether OAuth tokens are stored locally by the oauth client (not fully shown in truncated source) before trusting persistent behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install twitter-aisa-api - After installation, invoke the skill by name or use
/twitter-aisa-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Release focused on simplifying the runtime bundle and metadata for safe publication.
- Added publishing metadata: author, user-invocable flag, and file scoping in SKILL.md.
- Removed non-runtime and redundant files; only scripts and posting reference remain.
- Cleaned up requirements to only include Python 3 and AISA_API_KEY.
- Dropped references to curl and override environment variables in documentation.
v1.0.0
- Engagement actions (likes, follows, unlikes, unfollows) and related files have been removed; posting and research are now the focus.
- Skill renamed to "aisa-twitter-api" with an updated description and branding.
- Only supports reading Twitter/X data and posting tweets via OAuth—no longer processes engagement features.
- Documentation and quick reference have been updated for clarity and accuracy based on supported actions.
- Removed redundant files and references for engagement workflows.
Metadata
Frequently Asked Questions
What is twitter-aisa-api?
Search and read Twitter/X profiles, tweets, trends, and Spaces via AISA relay, then publish posts with OAuth and approved media files using AISA_API_KEY. It is an AI Agent Skill for Claude Code / OpenClaw, with 90 downloads so far.
How do I install twitter-aisa-api?
Run "/install twitter-aisa-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is twitter-aisa-api free?
Yes, twitter-aisa-api is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does twitter-aisa-api support?
twitter-aisa-api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created twitter-aisa-api?
It is built and maintained by bibaofeng (@bibaofeng); the current version is v1.0.1.
More Skills