io.github.RyanKramer/shippost-mcp
Twitter/X tools for AI agents — read timelines, post tweets, search, and engage
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
shippost-mcpclaude mcp add shippost-mcp -e 'TWITTER_ACCESS_TOKEN=<your twitter_access_token>' -e 'TWITTER_REFRESH_TOKEN=<your twitter_refresh_token>' -e 'TWITTER_CLIENT_ID=<TWITTER_CLIENT_ID>' -e 'SHIPPOST_API_KEY=<your shippost_api_key>' -- uvx shippost-mcp==0.1.1{
"mcpServers": {
"shippost-mcp": {
"command": "uvx",
"args": [
"shippost-mcp==0.1.1"
],
"env": {
"TWITTER_ACCESS_TOKEN": "<your twitter_access_token>",
"TWITTER_REFRESH_TOKEN": "<your twitter_refresh_token>",
"TWITTER_CLIENT_ID": "<TWITTER_CLIENT_ID>",
"SHIPPOST_API_KEY": "<your shippost_api_key>"
}
}
}
}متغيرات البيئة
TWITTER_ACCESS_TOKENإلزامي سري Your Twitter OAuth 2.0 access tokenTWITTER_REFRESH_TOKENسري Twitter refresh token for automatic renewalTWITTER_CLIENT_IDYour Twitter app client ID (needed for token refresh)SHIPPOST_API_KEYسري ShipPost API key for AI-powered features (get at https://shippost.ai)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
ShipPost MCP — Twitter/X tools for AI agents
Give any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X.
Quick Start
Claude Code
Add to your ~/.claude/settings.json:
{
"mcpServers": {
"twitter": {
"command": "shippost-mcp",
"env": {
"TWITTER_ACCESS_TOKEN": "your-access-token",
"TWITTER_REFRESH_TOKEN": "your-refresh-token",
"TWITTER_CLIENT_ID": "your-client-id"
}
}
}
}Install from PyPI
pip install shippost-mcpFree Tools
| Tool | Description |
|---|---|
get_my_profile | Get your Twitter profile |
get_timeline | Read your home timeline |
get_mentions | Get tweets mentioning you |
get_user_profile | Look up any user's profile |
get_tweet | Get a specific tweet by ID |
search_tweets | Search recent tweets |
post_tweet | Post a tweet |
reply_to_tweet | Reply to a tweet |
like_tweet | Like a tweet |
retweet | Retweet a tweet |
follow_user | Follow a user |
Paid AI Tools (requires ShipPost API key)
| Tool | Description |
|---|---|
find_opportunities | AI scans your timeline for the best tweets to reply to |
draft_reply | AI drafts a reply in your voice |
draft_tweet | AI drafts an original tweet |
draft_thread | AI drafts a full thread |
analyze_account | AI analyzes any Twitter account |
get_performance | AI-powered engagement analytics |
Get your API key at shippost.ai
Configuration
| Env Var | Required | Description |
|---|---|---|
TWITTER_ACCESS_TOKEN | Yes | OAuth 2.0 access token |
TWITTER_REFRESH_TOKEN | Recommended | For automatic token renewal |
TWITTER_CLIENT_ID | For refresh | Your Twitter app's client ID |
SHIPPOST_API_KEY | For AI features | Get at shippost.ai |
License
MIT
الأسئلة الشائعة
ما هو io.github.RyanKramer/shippost-mcp؟
Twitter/X tools for AI agents — read timelines, post tweets, search, and engage
كيف أثبّت io.github.RyanKramer/shippost-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add shippost-mcp -e 'TWITTER_ACCESS_TOKEN=<your twitter_access_token>' -e 'TWITTER_REFRESH_TOKEN=<your twitter_refresh_token>' -e 'TWITTER_CLIENT_ID=<TWITTER_CLIENT_ID>' -e 'SHIPPOST_API_KEY=<your shippost_api_key>' -- uvx shippost-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.RyanKramer/shippost-mcp إلى مفتاح API؟
نعم. يتطلب TWITTER_ACCESS_TOKEN, TWITTER_REFRESH_TOKEN, SHIPPOST_API_KEY، وتضبطها في إعداداته.
هل io.github.RyanKramer/shippost-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.RyanKramer/shippost-mcp؟
ينشره RyanKramer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.