Substack Fetcher MCP

🚀 Substack 閱讀器

Substack 閱讀器是一個實用工具，專為從 Adam Mancini 的 Trade Companion 時事通訊獲取和閱讀文章而設計，能幫助用戶便捷地獲取所需資訊。

🚀 快速開始

在開始使用 Substack 閱讀器之前，您需要完成安裝和相關設置。下面將為您詳細介紹具體步驟。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• Python 的 uv 包管理器
• Claude AI 助手

安裝步驟

1. 安裝 uv 包管理器：若尚未安裝 uv 包管理器，可使用以下命令進行安裝：

curl -sSf https://install.ultraviolet.dev | sh

2. 創建並激活虛擬環境：

uv venv
source .venv/bin/activate  # Windows 用戶請運行：.venv\Scripts\activate

3. 安裝依賴項：使用 pyproject.toml 文件安裝依賴項：

uv pip install -e .

Substack 身份驗證設置

若要訪問訂閱者專屬內容，您需提供 Substack cookies，具體操作如下：

1. 安裝 Cookie-Editor 擴展：在瀏覽器中安裝 Cookie-Editor 擴展，可通過以下鏈接進行安裝：
   • Chrome 網上應用商店
   • Firefox 插件
2. 登錄 Substack 賬戶：登錄到您的 Substack 賬戶 tradecompanion.substack.com
3. 導出 cookies：點擊 Cookie-Editor 擴展圖標，然後點擊 "導出" 並選擇 "導出為 JSON"，這會將 cookie 複製到剪貼板。
4. 創建並保存文件：在項目根目錄中創建文件 substack_cookies.json，將複製的 cookie 粘貼到此文件中並保存。

🔧 與 Claude 配合使用

該工具專為與 Claude AI 助手一起使用而設計，設置步驟如下：

1. 配置 Claude：在您的 Claude 配置文件中添加以下內容，以配置 Claude 使用此 MCP 服務器：

{
  "mcpServers": {
    "substack_reader": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/substack_reader",
        "run",
        "substack_reader.py"
      ]
    }
  },
  "globalShortcut": "Ctrl+Space"
}

請將 /path/to/substack_reader 替換為您實際的 substack_reader 目錄路徑。 2. 啟動 Claude：配置完成後，啟動 Claude 時會自動連接到此 MCP 服務器。 3. 檢索文章：啟動 Claude 後，您可以要求 Claude 檢索最新的 Trade Companion 文章。

✨ 主要特性

• 獲取最新文章：可獲取 Adam Mancini 的最新 Trade Companion 文章。
• 提取純文本內容：能將文章內容提取為純文本格式。
• 保留文章結構：保留標題、段落和列表項，方便閱讀。
• 排除特定文章：排除 "My Trade Methodology Fundamentals" 文章。

📄 隱私說明

您的 Substack cookies 存儲在本地的 substack_cookies.json 文件中，僅用於驗證請求到 Substack，不會以任何形式發送到其他地方或被洩露，請您放心使用。