TwtAPI

Access live Twitter/X data through TwtAPI's hosted public skill gateway. Search tweets, look up users, read timelines, inspect followers and following, fetch...

Security Scan

The skill's code, instructions, and requested credential align with its stated purpose (calling TwtAPI's hosted gateway using a dedicated skill key); only a small documentation/env-var omission was noted.

Purpose & Capability

Name/description (access Twitter/X via TwtAPI gateway) match the shipped CLI and network calls. The skill only requires python3 and a TwtAPI skill key, which are appropriate for this purpose.

Instruction Scope

SKILL.md stays within the expected scope (run the bundled CLI to call TwtAPI endpoints). It documents an optional TWTAPI_SKILL_BASE_URL you can set to override the gateway; this is reasonable but that optional env var is not listed in the registry metadata (minor inconsistency).

Install Mechanism

Install spec only suggests installing Python via Homebrew (official formula). No downloads from unknown servers or archive extraction; the code file is included in the package.

Credentials

Only one required env var (TWTAPI_SKILL_KEY) is declared and used as the primary credential — proportionate for a hosted gateway. The code and docs also optionally read TWTAPI_SKILL_BASE_URL, but that optional variable is not declared in the registry metadata (documentation/metadata mismatch). No unrelated credentials are requested.

Persistence & Privilege

Skill is not always-enabled and does not request elevated/persistent system privileges. It does network calls to the listed TwtAPI gateway (expected for its function).

Assessment

This skill appears to do what it claims: it runs a small Python CLI that posts queries to TwtAPI's gateway and requires a dedicated TWTAPI_SKILL_KEY. Before installing: 1) Confirm you trust the gateway domain (https://skill.twtapi.com or your self-hosted override) because your queries and the skill key are sent there. 2) Store the TWTAPI_SKILL_KEY securely (env or OpenClaw config) and use least-privilege/rotate keys if possible. 3) Note the minor metadata mismatch: the README/code accept an optional TWTAPI_SKILL_BASE_URL but it isn't declared in the registry metadata — if you plan to override the gateway, set that env var explicitly. 4) If you need extra assurance, review or run the included scripts in an isolated environment and monitor network traffic/credits on your TwtAPI dashboard.

TwtAPI - Twitter/X Data

Access live Twitter/X data through TwtAPI's hosted skill gateway. Search tweets, look up users, read timelines, browse followers, and check trends with structured JSON built for AI agents. Get your skill key at https://www.twtapi.com/en/.

Setup

1. Install the public skill:

clawhub install twtapi

2. Sign up and open the Skill tab in your TwtAPI dashboard.
3. Copy your dedicated skill_key.
4. Set the required environment variable:

export TWTAPI_SKILL_KEY="tsk-your-skill-key"

The public hosted gateway https://skill.twtapi.com is built in by default, so most users do not need to set a base URL.

If you are overriding the gateway for a self-hosted or custom deployment, you can optionally set:

export TWTAPI_SKILL_BASE_URL="https://your-skill-host.example.com"

If you use OpenClaw, you can also set skills."twtapi".env.TWTAPI_SKILL_KEY in ~/.openclaw/openclaw.json. Other compatible skill runners only need an equivalent way to inject TWTAPI_SKILL_KEY.

Verify the skill connection

Run this first after setup:

python3 {baseDir}/scripts/twtapi.py tools

If auth and routing are correct, you should get a JSON list of available skill tools.

Usage

Search tweets

python3 {baseDir}/scripts/twtapi.py search "AI agents"
python3 {baseDir}/scripts/twtapi.py search "#bitcoin" --type Top --count 10
python3 {baseDir}/scripts/twtapi.py search "from:elonmusk" --cursor "scroll_xxx"

Look up a user profile

python3 {baseDir}/scripts/twtapi.py user elonmusk
python3 {baseDir}/scripts/twtapi.py user-by-id 44196397

Get user tweets / replies / media

Requires a numeric user ID. Look up the user first if you only have a username.

python3 {baseDir}/scripts/twtapi.py tweets 44196397
python3 {baseDir}/scripts/twtapi.py tweets 44196397 --count 5
python3 {baseDir}/scripts/twtapi.py replies 44196397
python3 {baseDir}/scripts/twtapi.py media 44196397

Get a single tweet by ID

python3 {baseDir}/scripts/twtapi.py tweet 1897023456789012345

List followers / following

python3 {baseDir}/scripts/twtapi.py followers 44196397 --count 50
python3 {baseDir}/scripts/twtapi.py following 44196397

Get trending topics

python3 {baseDir}/scripts/twtapi.py trending

Workflow tips

• Username → user ID: run user <username> first, then use the rest_id from the result for tweets, followers, etc.
• Pagination: most list commands accept --cursor for the next page. The cursor value is included in the response when more results are available.
• Search operators: the search command supports Twitter search syntax — from:handle, to:handle, #hashtag, lang:en, date ranges, etc.

Notes

• This skill uses TwtAPI's hosted public gateway plus your dedicated skill_key, not your main API key.
• The hosted gateway is built in. Most end users only need TWTAPI_SKILL_KEY.
• Each API call consumes credits from your TwtAPI account.
• Returns raw Twitter JSON from the TwtAPI skill backend. Present results in a readable format with post content, author names, metrics, and timestamps.
• Rate limits and credit balance are managed by your plan.