social-search-mcp/
├── x-search/
│   ├── twitterapi-io.js   # X/Twitter 搜索 MCP（149 行，4 个工具）
│   └── README.md          # 模块级文档
├── reddit-search/
│   ├── reddit.js          # Reddit MCP（87 行，2 个工具）
│   ├── redlib-api.js      # Redlib → JSON API 转换层（242 行，纯 node 零依赖）
│   ├── DEPLOY.md          # Redlib Docker 部署备忘（含全部坑）
│   └── README.md          # 模块级文档
└── package.json           # 唯一依赖：@modelcontextprotocol/sdk

query → 自动追加 -filter:retweets → twitterapi.io advanced_search
  → fmtTweet 字段规整（author/likes/retweets/views/createdAt）
  → engagement 重排：score = 赞 + 转推×2 + 回复 + 引用（降序）
  → cleanTweets 清洗：
      · 剥掉 t.co 短链后取 60 字符指纹去重（近似文本）
      · 丢掉纯链接推（零信息量）
  → 紧凑 markdown 输出（engagement 标注 + 原文链接）

agent (MCP stdio)
   │  reddit.js —— 薄 wrapper，调 HTTP、格式化 markdown
   ▼
redlib-api (:8091)
   │  redlib-api.js —— 抓 Redlib HTML → 解析成结构化 JSON
   │  附带：跨版去重 + engagement 重排 + 评论树清洗
   ▼
Redlib docker (:8090)
   │  官方匿名 client token 通道
   ▼
Reddit

rank = W.eng × engagement + W.fresh × freshness + W.rel × relevance − W.div × 版内序号

engagement = ln(1+score) + 1.5 × ln(1+comments)   # 评论权重 1.5 倍：讨论密度比票数更代表信息价值
freshness  = 0.5 ^ (帖龄天数 / 半衰期)
relevance  = 标题命中 query 词数 / query 总词数

GET /api/health                                    # {"ok":true}
GET /api/search?q=opencode&mode=discussion&limit=10
GET /api/search?q=claude&sub=ClaudeAI&t=week       # 限定版块+时间窗
GET /api/post?path=/r/opencode/comments/xxx/title/&max_comments=15&max_depth=3

git clone https://github.com/vialan-art/social-search-mcp.git
cd social-search-mcp
npm install
TWITTERAPI_IO_KEY=你的key node x-search/twitterapi-io.js

npm install
REDLIB_API_BASE=https://你的redlib域名/api node reddit-search/reddit.js

# ⚠️ 必须源码构建！quay.io 预构建镜像的匿名 OAuth 已坏（issue #551，2026-04 起）
git clone https://github.com/redlib-org/redlib.git /opt/redlib
cd /opt/redlib

# 1G 内存 VPS 必加这一行到 Dockerfile.ubuntu 构建阶段前，否则 cargo 编译 OOM：
# ENV CARGO_BUILD_JOBS=2
docker build -f Dockerfile.ubuntu -t redlib:local .

# 只绑 localhost，由 nginx 反代出公网
docker run -d --name redlib --restart unless-stopped -p 127.0.0.1:8090:8080 redlib:local

mkdir -p /opt/redlib-api
cp reddit-search/redlib-api.js /opt/redlib-api/index.js

[Unit]
Description=redlib-api
After=network.target docker.service

[Service]
ExecStart=/usr/bin/node /opt/redlib-api/index.js
Environment=PORT=8091
Environment=REDLIB_BASE=http://127.0.0.1:8090
Restart=always

[Install]
WantedBy=multi-user.target

systemctl enable --now redlib-api

server {
    listen 443 ssl;
    server_name redlib.你的域名;
    ssl_certificate     /path/to/origin.pem;
    ssl_certificate_key /path/to/origin.key;

    location /api/ { proxy_pass http://127.0.0.1:8091; }
    location /     { proxy_pass http://127.0.0.1:8090; }
}

curl https://redlib.你的域名/r/opencode                     # 25 帖列表 HTML
curl "https://redlib.你的域名/api/health"                   # {"ok":true}
curl "https://redlib.你的域名/api/search?q=opencode&limit=5" # 结构化 JSON

REDLIB_API_BASE=https://redlib.你的域名/api node reddit-search/reddit.js

{
  "mcpServers": {
    "x-search": {
      "command": "node",
      "args": ["/绝对路径/social-search-mcp/x-search/twitterapi-io.js"],
      "env": { "TWITTERAPI_IO_KEY": "你的key" }
    },
    "reddit": {
      "command": "node",
      "args": ["/绝对路径/social-search-mcp/reddit-search/reddit.js"],
      "env": { "REDLIB_API_BASE": "https://redlib.你的域名/api" }
    }
  }
}

{
  "mcp": {
    "x-search": {
      "type": "local",
      "command": ["node", "/绝对路径/social-search-mcp/x-search/twitterapi-io.js"],
      "environment": { "TWITTERAPI_IO_KEY": "你的key" }
    },
    "reddit": {
      "type": "local",
      "command": ["node", "/绝对路径/social-search-mcp/reddit-search/reddit.js"],
      "environment": { "REDLIB_API_BASE": "https://redlib.你的域名/api" }
    }
  }
}