shippost-mcp

Name: shippost-mcp
Author: RyanKramer

本地服务

github.com/RyanKramer社交媒体031 周前更新

代码仓库

关于 shippost-mcp

shippost-mcp 为 AI Agent 提供 Twitter/X 的读取、发布和互动工具，涵盖时间线、搜索、推文及账号操作。部分 AI 起草与分析功能需要 ShipPost API 密钥。

主要功能

01读取主页时间线和提及
02查询用户资料及推文
03搜索近期推文
04发布、回复、点赞和转推
05关注用户
06生成推文草稿并分析账号

适用场景

01让 AI Agent 汇总时间线和提及
02搜索近期推文并查阅账号
03通过 Agent 发布推文或回复
04借助 AI 起草推文和分析互动表现

MCP 相关

作为 MCP 服务，它向 AI 客户端提供 Twitter/X 读取、发布和互动工具。AI 起草、机会发现及分析功能需要 ShipPost API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ryankramer-shippost": {
      "command": "uvx",
      "args": [
        "shippost-mcp"
      ],
      "env": {
        "TWITTER_ACCESS_TOKEN": "<TWITTER_ACCESS_TOKEN>",
        "TWITTER_REFRESH_TOKEN": "<TWITTER_REFRESH_TOKEN>",
        "TWITTER_CLIENT_ID": "<TWITTER_CLIENT_ID>",
        "SHIPPOST_API_KEY": "<SHIPPOST_API_KEY>"
      }
    }
  }
}

启动命令uvx shippost-mcp

需要配置的环境变量

TWITTER_ACCESS_TOKEN密钥Your Twitter OAuth 2.0 access token

TWITTER_REFRESH_TOKEN密钥Twitter refresh token for automatic renewal

TWITTER_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)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypishippost-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

ShipPost MCP — 面向 AI Agent 的 Twitter/X 工具

让任何 AI Agent（Claude Code、Cursor、Windsurf 等）都能在 Twitter/X 上读取、发布内容并互动。

快速开始

Claude Code

添加到你的 ~/.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"
      }
    }
  }
}

从 PyPI 安装

pip install shippost-mcp

免费工具

工具	说明
`get_my_profile`	获取你的 Twitter 个人资料
`get_timeline`	阅读你的主页时间线
`get_mentions`	获取提及你的推文
`get_user_profile`	查找任意用户的个人资料
`get_tweet`	根据 ID 获取指定推文
`search_tweets`	搜索近期推文
`post_tweet`	发布推文
`reply_to_tweet`	回复推文
`like_tweet`	点赞推文
`retweet`	转发推文
`follow_user`	关注用户

付费 AI 工具（需要 ShipPost API 密钥）

工具	说明
`find_opportunities`	AI 扫描你的时间线，寻找最值得回复的推文
`draft_reply`	AI 用你的口吻起草回复
`draft_tweet`	AI 起草原创推文
`draft_thread`	AI 起草完整推文串
`analyze_account`	AI 分析任意 Twitter 账号
`get_performance`	AI 驱动的互动数据分析

在 shippost.ai 获取 API 密钥

配置

环境变量	必需	说明
`TWITTER_ACCESS_TOKEN`	是	OAuth 2.0 访问令牌
`TWITTER_REFRESH_TOKEN`	建议	用于自动续期令牌
`TWITTER_CLIENT_ID`	用于续期	你的 Twitter 应用客户端 ID
`SHIPPOST_API_KEY`	用于 AI 功能	在 shippost.ai 获取