← Back to Skills Marketplace
Twitter
Twitter API
by
justoneapi
· GitHub ↗
· v1.0.7
· MIT-0
165
Downloads
0
Stars
1
Active Installs
8
Versions
Install in OpenClaw
/install justoneapi-twitter
Description
Analyze Twitter workflows with JustOneAPI, including user Profile and user Published Posts.
README (SKILL.md)
This skill wraps 2 Twitter operations exposed by JustOneAPI. It is strongest for user Profile and user Published Posts. Expect common inputs such as restId, cursor.
When To Use It
- The user needs user Profile or user Published Posts on Twitter.
- The user can provide identifiers or filters such as
restId,cursor. - The user wants an exact API-backed answer instead of a freeform summary.
Representative Operations
getTwitterUserDetailV1: User Profile — Get Twitter user Profile data, including account metadata, audience metrics, and verification-related fields, for accessing user profile metadata (e.g., description, location, verification status) and collecting follower and following countsgetTwitterUserPostsV1: User Published Posts — Get Twitter user Published Posts data, including post content, timestamps, and engagement data, for account monitoring and content analysis
Request Pattern
- 2 operations are available in this skill.
- HTTP methods used here:
GET. - The most common non-token parameters are
restId,cursor. - All operations in this skill are parameter-driven requests; none require a request body.
How To Work
- Read
generated/operations.mdbefore choosing an endpoint. - Start with one of these operations when it matches the user's request:
getTwitterUserDetailV1,getTwitterUserPostsV1. - Pick the smallest matching operation instead of guessing.
- Ask the user for any missing required parameter. Do not invent values.
- Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'
Environment
- Required:
JUST_ONE_API_TOKEN - This skill uses
JUST_ONE_API_TOKENonly for authenticated Just One API requests. - Keep
JUST_ONE_API_TOKENprivate. Do not paste it into chat messages, screenshots, or logs. - Get a token from Just One API Dashboard.
- Authentication details: Just One API Usage Guide.
Output Rules
- Start with a plain-language answer tied to the Twitter task the user asked for.
- Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
- When using
getTwitterUserDetailV1, explain why the returned fields answer the user's question. - If the user gave filters such as
restId,cursor, echo those back so the scope is explicit. - If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill is internally consistent with its stated purpose: it requires node and a JustOneAPI token and calls api.justoneapi.com endpoints for Twitter profile/posts. Before installing, ensure the JUST_ONE_API_TOKEN you provide has only the necessary permissions and that you are comfortable with the token being sent as a query parameter (which can be logged by intermediaries). If you require stricter secrecy, ask the provider whether an Authorization header or different authentication method is available. Finally, confirm you trust JustOneAPI as the external service receiving your token and requests.
Capability Analysis
Type: OpenClaw Skill
Name: justoneapi-twitter
Version: 1.0.7
The skill is a standard API wrapper for JustOneAPI's Twitter endpoints, specifically for retrieving user profiles and posts. The implementation in `bin/run.mjs` is clean, using built-in Node.js features to safely construct requests and handle parameters with proper encoding. The instructions in `SKILL.md` are well-aligned with the stated purpose and include explicit warnings to keep authentication tokens private, showing no signs of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
Name/description, required binary (node), and required env var (JUST_ONE_API_TOKEN) all match a small wrapper that calls JustOneAPI endpoints for Twitter user profile and posts. The included operations and parameters are consistent with the declared purpose.
Instruction Scope
SKILL.md instructs the agent to call the provided bin/run.mjs script with an operation, token, and parameters; the runtime instructions only reference the generated operation docs and required parameters and do not request unrelated files, system state, or other credentials.
Install Mechanism
There is no separate install spec (instruction-only style); a small JS CLI (bin/run.mjs) is included but does not download or execute remote code. This is low-risk compared with remote installers or archive downloads.
Credentials
The skill requests only JUST_ONE_API_TOKEN, which is appropriate. Implementation injects the token into the API request as a query parameter (per the OpenAPI parameters). Note: passing secrets in query strings can expose them in logs, proxy traces, or browser history — consider token scope and rotation accordingly. The script itself does not read arbitrary environment variables.
Persistence & Privilege
always is false and the skill does not request persistent or system-wide privileges, nor does it modify other skills or system config. Autonomous invocation is allowed (platform default) but not combined with elevated privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install justoneapi-twitter - After installation, invoke the skill by name or use
/justoneapi-twitter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
- Operation IDs updated from getUserDetailV1 / getUserPostsV1 to getTwitterUserDetailV1 / getTwitterUserPostsV1 to better clarify endpoint purposes.
- Documentation and references updated to align with new operation names.
- No changes to required parameters, authentication, or skill functionality.
v1.0.6
- Updated authentication documentation links for more accurate and consistent instructions.
- No changes to functionality or technical requirements.
v1.0.5
- Updated the Just One API Dashboard link in the Environment section with UTM parameters for improved tracking.
- No functional or workflow changes; documentation/metadata improvement only.
v1.0.4
Version 1.0.4
- SKILL.md updated to clarify environment variable usage.
- Now explicitly states that JUST_ONE_API_TOKEN is only used for authenticated API requests.
- No changes to skill operations or API functionality.
v1.0.3
- Added explicit instruction to keep the JUST_ONE_API_TOKEN private in the Environment section.
- No functional or API changes; documentation only.
- Improved security guidance for handling authentication tokens.
v1.0.2
- Added instructions on obtaining and configuring the required API token from the JustOneAPI Dashboard.
- Included authentication details and a link to the Just One API usage guide.
- No changes to core functionality or APIs.
v1.0.1
rename
v1.0.0
Initial release of the Twitter API skill using JustOneAPI.
- Provides two main operations: fetch Twitter user profile details and fetch user published posts.
- Supports parameter-driven GET requests with common inputs like restId and cursor.
- Requires JUST_ONE_API_TOKEN environment variable for authentication.
- Designed for exact, API-backed Twitter data queries—profile metadata and post history.
- Includes guidelines for usage, decision-relevant output, and clear handling of required parameters and backend errors.
Metadata
Frequently Asked Questions
What is Twitter API?
Analyze Twitter workflows with JustOneAPI, including user Profile and user Published Posts. It is an AI Agent Skill for Claude Code / OpenClaw, with 165 downloads so far.
How do I install Twitter API?
Run "/install justoneapi-twitter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Twitter API free?
Yes, Twitter API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Twitter API support?
Twitter API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Twitter API?
It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.7.
More Skills