Integration
X / Twitter
Connect your agent to the X/Twitter API. Read timelines, post tweets, search, and track mentions with full OAuth 1.0a support.
⚠️
OAuth 1.0a required for write access
Posting tweets, reading your timeline, and getting mentions all require OAuth 1.0a credentials (API Key + Secret + Access Token + Secret). A Bearer Token only works for public search.
Setup Guide#
1
Apply for X API Access
Go to the X Developer Portal and apply for API access. You need at least the Basic tier ($100/mo from X) for read + write access.
2
Create a Project & App
Create a new project and app in the Developer Portal. Under User Authentication Settings, enable OAuth 1.0a with Read and Write permissions.
3
Generate Credentials
In your app's Keys and Tokens tab, generate:
- API Key (Consumer Key)
- API Secret (Consumer Secret)
- Access Token
- Access Token Secret
- Bearer Token (optional, for search-only)
4
Add to Lobstack
Go to Dashboard → Skills → X/Twitter → ⚙️ and enter all five credential fields.
Available Tools#
| Tool | Description | Auth Required |
|---|---|---|
| twitter_read_timeline | Read your home timeline (recent tweets) | OAuth 1.0a |
| twitter_post_tweet | Post a new tweet (max 280 chars) | OAuth 1.0a |
| twitter_search_tweets | Search recent tweets by keyword | OAuth 1.0a or Bearer |
| twitter_get_mentions | Get recent @mentions of your account | OAuth 1.0a |
Authentication Modes#
The Twitter integration supports two authentication modes:
- OAuth 1.0a — Full user-context access (read + write). Uses HMAC-SHA1 request signing. Required for posting tweets, reading timeline, and getting mentions.
- Bearer Token — App-only access (read-only). Only works for public search. Cannot post tweets or access user-specific data.
✅
Best practice
Always provide all four OAuth 1.0a credentials for full functionality. The Bearer Token is optional and only useful as a fallback for public search.
Example Prompts#
text
"Show me my latest Twitter timeline"
"Post a tweet: 'Just deployed my AI agent with @LobstackAI!'"
"Search Twitter for 'AI agents' and summarize the top results"
"Check if anyone has mentioned me on Twitter recently"