← Back to Skills Marketplace
bibaofeng

AIsa Twitter Engagement Suite

by bibaofeng · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
87
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install aisa-twitter-engagement-suite
Description
Search X/Twitter profiles, tweets, trends, and OAuth-gated posting through AIsa. Use when: the user needs Twitter research, monitoring, or engagement workflo...
README (SKILL.md)

AIsa Twitter Engagement Suite

Search X/Twitter profiles, tweets, trends, and OAuth-gated posting through AIsa. Use when: the user needs Twitter research, monitoring, or engagement workflows. Supports search, monitoring, and approved posting.

When to use

  • The user needs Twitter/X research, monitoring, posting, or engagement workflows.
  • The user wants profiles, timelines, trends, lists, communities, or Spaces.
  • The user wants approved posting without sharing passwords.

High-Intent Workflows

  • Research an account or conversation thread.
  • Monitor a keyword, trend, or competitor.
  • Authorize and publish a post after explicit approval.

Quick Reference

  • python3 scripts/twitter_client.py --help
  • python3 scripts/twitter_engagement_client.py --help
  • python3 scripts/twitter_oauth_client.py --help

Setup

  • AISA_API_KEY is required for AIsa-backed API access.
  • Use repo-relative scripts/ paths from the shipped package.
  • Prefer explicit CLI auth flags when a script exposes them.

Example Requests

  • Research recent AI agent conversations on X
  • Search how users are reacting to a product launch on Twitter
  • Authorize and publish a short product update post

Guardrails

  • Do not ask for passwords, cookies, or browser credentials.
  • Do not claim posting succeeded until the API confirms it.
  • Return authorization links instead of relying on auto-open behavior.
Usage Guidance
This package is internally consistent, but you should verify you trust the AIsa relay (api.aisa.one) before supplying AISA_API_KEY. Treat the AISA_API_KEY like any secret key — limit its scope/rotation if possible. Review the bundled scripts yourself (they are included) if you need high assurance, and be cautious when allowing the skill to upload local workspace files or open your browser (the code supports --open-browser). If you prefer, create a dedicated, limited-scope AISA key for this skill rather than reusing keys used elsewhere.
Capability Analysis
Type: OpenClaw Skill Name: aisa-twitter-engagement-suite Version: 1.0.0 The skill bundle provides a comprehensive suite for interacting with Twitter/X via the AIsa API relay (api.aisa.one). It includes scripts for searching, engagement (like/follow), and OAuth-based posting with media support. The code is well-structured, uses standard Python libraries (urllib), and implements specific security guardrails, such as mime-type validation in `twitter_oauth_client.py` to ensure only images/videos are uploaded and explicit instructions in `SKILL.md` and `references/` advising the agent never to request user passwords or cookies.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentialsposts-externally
Capability Assessment
Purpose & Capability
Name/description match the packaged scripts and SKILL.md. The three Python clients implement read APIs, engagement (like/follow) relay actions, and OAuth-based posting. The only required env var is AISA_API_KEY and required binary is python3 — both expected for a relay-backed Twitter client.
Instruction Scope
SKILL.md instructions are scoped to searching, monitoring, and authorized posting. The instructions and reference files explicitly require AISA_API_KEY, call repo-relative scripts, and warn against asking for passwords/cookies. The scripts call the AIsa relay endpoints and only reference local workspace file paths for media uploads (consistent with the posting use case).
Install Mechanism
No install spec is present (instruction-only skill); bundled Python scripts are run directly. Nothing is downloaded or written to system locations by an installer step, so installation risk is low.
Credentials
Only AISA_API_KEY is required and used throughout the code to authenticate to api.aisa.one. No unrelated credentials, secrets, or config paths are requested. The key is the primary credential expected for a relay service.
Persistence & Privilege
The skill is not always-enabled, does not request system-wide configuration changes, and does not modify other skills. It runs as-needed and relies on the provided environment variable.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install aisa-twitter-engagement-suite
  3. After installation, invoke the skill by name or use /aisa-twitter-engagement-suite
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of AIsa Twitter Engagement Suite. - Search Twitter (X) profiles, tweets, and trends for research or monitoring. - Monitor keywords, trends, or competitors with dedicated workflows. - OAuth-gated posting allows secure, approval-based publishing without sharing passwords. - Requires AISA_API_KEY for all API access. - Compatible with OpenClaw, Claude Code, and Hermes environments.
Metadata
Slug aisa-twitter-engagement-suite
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is AIsa Twitter Engagement Suite?

Search X/Twitter profiles, tweets, trends, and OAuth-gated posting through AIsa. Use when: the user needs Twitter research, monitoring, or engagement workflo... It is an AI Agent Skill for Claude Code / OpenClaw, with 87 downloads so far.

How do I install AIsa Twitter Engagement Suite?

Run "/install aisa-twitter-engagement-suite" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AIsa Twitter Engagement Suite free?

Yes, AIsa Twitter Engagement Suite is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does AIsa Twitter Engagement Suite support?

AIsa Twitter Engagement Suite is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created AIsa Twitter Engagement Suite?

It is built and maintained by bibaofeng (@bibaofeng); the current version is v1.0.0.

💬 Comments