OpenParable
Skip to content
← Back to skills

Twitter User Skill

Apps & Automation
twitter-user-skill

Twitter User Skill is an Agent Skill for apps & automation published in the zeenie-ai/OpenCompany repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Look up Twitter/X user profiles with descriptions, get authenticated user info, and retrieve followers/following lists with profile details.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/zeenie-ai/OpenCompany/blob/HEAD/server/skills/social_agent/twitter-user-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/twitter-user-skill, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Twitter User Tool

Look up user profiles and social connections on Twitter/X via X API v2.

How It Works

This skill provides instructions for the Twitter User tool node. Connect the Twitter User node to an AI Agent's input-tools handle to enable user lookups.

All operations use OAuth 2.0 user context with automatic token refresh on expiry.

twitter_user Tool

Retrieve user information and social connections.

Schema Fields

FieldTypeRequiredDescription
operationstringYesOperation type: me, by_username, by_id, followers, following
usernamestringIf by_usernameTwitter username (without @)
user_idstringIf by_id/followers/followingTwitter user ID
max_resultsintegerNoFor followers/following (1-1000, default: 100)

Operations

OperationRequired FieldsDescriptionRate Limit (free tier)
menoneGet authenticated user's profile25 req/24hr
by_usernameusernameLook up user by username100 req/24hr
by_iduser_idLook up user by ID100 req/24hr
followersuser_id (optional)Get user's followers (defaults to authenticated user)15 req/15min
followinguser_id (optional)Get accounts user follows (defaults to authenticated user)15 req/15min

Examples

Get my profile:

{
  "operation": "me"
}

Look up user by username:

{
  "operation": "by_username",
  "username": "elonmusk"
}

Look up user by ID:

{
  "operation": "by_id",
  "user_id": "44196397"
}

Get my followers:

{
  "operation": "followers",
  "max_results": 100
}

Get accounts I follow:

{
  "operation": "following",
  "max_results": 50
}

Get another user's followers:

{
  "operation": "followers",
  "user_id": "44196397",
  "max_results": 200
}

Response Format - Single User

All user lookups return profile data including description and account creation date:

{
  "success": true,
  "result": {
    "id": "44196397",
    "username": "elonmusk",
    "name": "Elon Musk",
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
    "verified": true,
    "description": "Mars & Cars, Chips & Dips",
    "created_at": "2009-06-02 20:12:29+00:00"
  },
  "execution_time": 0.35
}

Response Format - User List (Followers/Following)

{
  "success": true,
  "result": {
    "users": [
      {
        "id": "123456789",
        "username": "user1",
        "name": "User One",
        "profile_image_url": "https://pbs.twimg.com/...",
        "verified": false,
        "description": "Software developer and open source enthusiast",
        "created_at": "2020-03-15 08:30:00+00:00"
      }
    ],
    "count": 100
  },
  "execution_time": 1.2
}

Key Response Fields

FieldDescription
idUnique numeric user ID (use for followers/following lookups)
usernameHandle without @ (use for by_username lookups)
nameDisplay name
profile_image_urlURL to profile picture
verifiedWhether the account is verified
descriptionUser's bio text
created_atAccount creation timestamp

Error Response

{
  "success": false,
  "error": "Username is required",
  "execution_time": 0.01
}

Guidelines

  1. Usernames: Provide without the @ symbol (e.g., elonmusk not @elonmusk)
  2. User IDs: Use the numeric ID string. Get these from search results (author_id) or user lookups
  3. Rate limits: me endpoint is heavily rate-limited (25/24hr on free tier) -- avoid calling repeatedly
  4. Max results: Minimum 1, maximum 1000 per request for followers/following
  5. Pagination: Only the first page is returned. For large accounts, max_results controls page size
  6. Defaults to self: If user_id is omitted for followers/following, it defaults to the authenticated user
  7. Token refresh: If a 401/403 error occurs, the system automatically refreshes the OAuth token and retries

Common Use Cases

  • Get your own profile information and bio
  • Look up profiles of users you interact with
  • Check if users are verified
  • Analyze follower/following relationships and growth
  • Build lists of relevant accounts in a niche
  • Get user IDs from usernames for use in search queries (e.g., from:username)
  • Compare follower counts between accounts

Setup Requirements

  1. Connect the Twitter User node to an AI Agent's input-tools handle
  2. Ensure Twitter is connected (authenticated via OAuth in Credentials Modal)
  3. Your X Developer account must have appropriate API access level
  4. Required OAuth scopes: users.read, follows.read, offline.access