🚀 Substack 阅读器
Substack 阅读器是一个实用工具，专为从 Adam Mancini 的 Trade Companion 时事通讯获取和阅读文章而设计，能帮助用户便捷地获取所需资讯。
🚀 快速开始
在开始使用 Substack 阅读器之前，您需要完成安装和相关设置。下面将为您详细介绍具体步骤。
📦 安装指南
先决条件
- Python 3.8 或更高版本
- Python 的 uv 包管理器
- Claude AI 助手
安装步骤
- 安装 uv 包管理器：若尚未安装 uv 包管理器，可使用以下命令进行安装：
curl -sSf https://install.ultraviolet.dev | sh
- 创建并激活虚拟环境：
uv venv
source .venv/bin/activate # Windows 用户请运行：.venv\Scripts\activate
- 安装依赖项：使用 pyproject.toml 文件安装依赖项：
uv pip install -e .
Substack 身份验证设置
若要访问订阅者专属内容，您需提供 Substack cookies，具体操作如下：
- 安装 Cookie-Editor 扩展：在浏览器中安装 Cookie-Editor 扩展，可通过以下链接进行安装：
- 登录 Substack 账户：登录到您的 Substack 账户 tradecompanion.substack.com
- 导出 cookies：点击 Cookie-Editor 扩展图标，然后点击 "导出" 并选择 "导出为 JSON"，这会将 cookie 复制到剪贴板。
- 创建并保存文件：在项目根目录中创建文件
substack_cookies.json，将复制的 cookie 粘贴到此文件中并保存。
🔧 与 Claude 配合使用
该工具专为与 Claude AI 助手一起使用而设计，设置步骤如下：
- 配置 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，不会以任何形式发送到其他地方或被泄露，请您放心使用。