socials-mcp 0.1.0__tar.gz

socials_mcp-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+.env
+*.egg-info/
+dist/
+build/
+.DS_Store
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/

socials_mcp-0.1.0/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+
+Copyright (c) 2026 nyrhe
+
+Permission is hereby granted...

socials_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+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

socials_mcp-0.1.0/README.md

@@ -0,0 +1,98 @@
+# 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

socials_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "socials-mcp"
+version = "0.1.0"
+description = "MCP server unifié pour X/Twitter et Reddit — tout-en-un, pas de CLI externe"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "nyrhe"}]
+keywords = ["mcp", "twitter", "reddit", "x", "socials"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx",
+    "rdt-cli>=0.4.0",
+    "browser-cookie3>=0.19",
+    "click>=8.0",
+    "rich>=13.0",
+    "PyYAML>=6.0",
+    "curl-cffi>=0.7",
+    "x-client-transaction>=0.4.1",
+    "beautifulsoup4>=4.12",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0"]
+
+[project.urls]
+Homepage = "https://github.com/nyrhe/socials-mcp"
+Repository = "https://github.com/nyrhe/socials-mcp"
+Issues = "https://github.com/nyrhe/socials-mcp/issues"
+
+[project.scripts]
+socials-mcp = "socials_mcp.server:main"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/socials_mcp", "src/twitter_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/socials_mcp", "/src/twitter_cli", "/README.md", "/LICENSE"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra"
+markers = [
+    "live: hits the real X/Reddit CLIs (needs login cookies); run with SOCIALS_MCP_LIVE=1",
+]

socials_mcp-0.1.0/src/socials_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"