Metadata-Version: 2.5
Name: socials-mcp
Version: 0.1.0
Summary: MCP server unifié pour X/Twitter et Reddit — tout-en-un, pas de CLI externe
Project-URL: Homepage, https://github.com/nyrhe/socials-mcp
Project-URL: Repository, https://github.com/nyrhe/socials-mcp
Project-URL: Issues, https://github.com/nyrhe/socials-mcp/issues
Author: nyrhe
License: MIT
License-File: LICENSE
Keywords: mcp,reddit,socials,twitter,x
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: browser-cookie3>=0.19
Requires-Dist: click>=8.0
Requires-Dist: curl-cffi>=0.7
Requires-Dist: httpx
Requires-Dist: mcp>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rdt-cli>=0.4.0
Requires-Dist: rich>=13.0
Requires-Dist: x-client-transaction>=0.4.1
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# socials-mcp

Unified MCP server for **X/Twitter** and **Reddit**.

> **MCP name:** `socials` — one server, two platforms.

## Install

```bash
pip install git+https://github.com/nyrhe/socials-mcp
```

Or with uvx:

```bash
uvx --from git+https://github.com/nyrhe/socials-mcp socials-mcp
```

Login once (this only writes the cookies the libraries read):

```bash
twitter login
rdt login
```

## Backend

100 % native: every tool imports `twitter_cli` / `rdt_cli` and calls
`TwitterClient` / `RedditClient` in-process. No subprocess, no CLI binary
invoked at runtime — `SOCIALS_X_COOKIES_FILE`, `TWITTER_AUTH_TOKEN` and
`TWITTER_CT0` are enough to run without any `twitter`/`rdt` executable.

## Config

```json
{
  "mcpServers": {
    "socials": {
      "command": "socials-mcp"
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `reddit_search` | Search Reddit |
| `reddit_read` | Read post + comments |
| `reddit_sub` | Browse subreddit |
| `reddit_sub_info` | Subreddit info |
| `reddit_user` | User profile |
| `reddit_user_posts` | User posts |
| `reddit_user_comments` | User comments |
| `reddit_popular` | Popular posts (/r/popular) |
| `reddit_popular_all` | Browse r/all |
| `reddit_feed` | Home feed (requires login) |
| `reddit_saved` | Saved posts (requires login) |
| `reddit_upvoted` | Upvoted posts (requires login) |
| `reddit_whoami` | Current account (requires login) |
| `reddit_status` | Auth status (requires login) |
| `reddit_comment` | Post a comment (requires login) |
| `reddit_save` | Save a post (requires login) |
| `reddit_upvote` | Upvote a post (requires login) |
| `reddit_subscribe` | Subscribe to subreddit (requires login) |
| `x_user` | User profile |
| `x_tweet` | Tweet + replies |
| `x_user_posts` | User tweets |
| `x_article` | Fetch Article |
| `x_search` | Search tweets (requires login) |
| `x_feed` | Home timeline (requires login) |
| `x_bookmarks` | Bookmarks (requires login) |
| `x_whoami` | Current account (requires login) |
| `x_status` | Auth status (requires login) |
| `x_post` | Post a tweet (requires login) |
| `x_follow` | Follow user (requires login) |
| `x_unfollow` | Unfollow user (requires login) |
| `x_followers` | List followers (requires login) |
| `x_following` | List following (requires login) |
| `x_like` | Like tweet (requires login) |
| `x_unlike` | Unlike tweet (requires login) |
| `x_likes` | Liked tweets (requires login) |
| `x_retweet` | Retweet (requires login) |
| `x_unretweet` | Undo retweet (requires login) |
| `x_reply` | Reply to tweet (requires login) |
| `x_quote` | Quote tweet (requires login) |
| `x_bookmark` | Bookmark tweet (requires login) |
| `x_unbookmark` | Remove bookmark (requires login) |
| `x_delete` | Delete tweet (requires login) |
| `x_list` | Fetch List tweets (requires login) |
| `socials_status` | Auth status X + Reddit |
| `reddit_login_help` | Login help Reddit |
| `x_login_help` | Login help X |

## License

MIT
