一个MCP服务器,允许AI代理(如Claude、Cursor)通过第三方API和Substack cookie身份验证来创建、发布和安排Substack文章。

Stars

69

7 天增长

暂无数据

Fork 数

0

开放 Issue

2

开源协议

暂无数据

最近更新

2026-07-28

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

填补了Substack缺乏原生发布API的空白,让作者能通过AI代理实现内容工作流自动化。

适合谁使用

  • 使用AI编程代理的Substack作者
  • 构建AI驱动内容自动化的开发者
  • Claude、Cursor等MCP主机的重度用户
  • 希望简化发布流程的内容创作者

典型使用场景

  • 通过AI代理起草和发布文章
  • 安排文章在未来发布
  • 管理文章的标签和元数据
  • 将Substack发布集成到自动化工作流中

项目优势

  • 提供全面的工具集(创建、发布、安排、标签)
  • 与Claude Desktop、Cursor等主流MCP主机无缝配合
  • 利用现有的Substack cookie认证,无需官方API
  • 提供所需API密钥的免费试用

使用前须知

  • 依赖第三方API服务(apisubstack.com)和易过期的Substack cookie
  • 非官方支持的解决方案,使用风险自负
  • 需要手动提取和刷新substack.sid cookie

README 快速开始

Substack API MCP

Substack does not provide a native public API for publishing posts.

But authors who want to draft, publish, and schedule from AI agents (Cursor, Claude, and other MCP hosts) still need a way out. This is the MCP server to publish to Substack via any agent.

Will not start without a valid APISUBSTACK_API_KEY (ask_*). Get API key here: apisubstack.com.

Why this exists

RealityWhat we built
No official Substack write/publish API for authorsA posting MCP so agents can create drafts, publish now, and schedule
Authors live in the browser editorAuthors publish through their agents instead
Session-cookie auth is the practical path todaysubstack.sid + your publication URL, gated by an API Substack key

Examples

Tools

ToolDescription
test_connectionVerify substack.sid and return profile
create_postCreate draft / publish now / schedule (+ optional tags)
get_draftFetch draft by id
update_draftUpdate draft fields
publish_postPublish existing draft
schedule_postSchedule existing draft
delete_draftDelete draft
list_tagsList publication tags
create_tagCreate tag
set_tagsEnsure + attach tags
get_post_tagsList tags on a post/draft

Install

cd /path/to/Substack-API-MCP
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Auth env

  1. Sign in at apisubstack.com, start the free trial, generate an ask_* API key.
  2. Copy your Substack substack.sid cookie:
    • Open Chrome and sign in to Substack.
    • Open DevTools → ApplicationCookies.
    • Select https://substack.com (or your publication host, e.g. https://yourname.substack.com).
    • Find the cookie named substack.sid and copy its Value.
  3. Export:
export APISUBSTACK_API_KEY="ask_YOUR_KEY"
export SUBSTACK_PUBLICATION_URL="https://yourname.substack.com"
export SUBSTACK_SID="YOUR_SUBSTACK_SID_VALUE"
# optional
# export SUBSTACK_USER_ID="123456"

Cookies expire. If you get 401/403, refresh substack.sid and try again.

Run

substack-api-mcp
# or
python -m substack_api_mcp

Cursor / Claude Desktop config

See `mcp.example.

项目描述

MCP server for Substack posts (FastMCP + substack-api-client)

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

gavamedia
精选
gavamedia GitHub avatar

deltafin

Deltafin is a research project that runs the 2.8-trillion-parameter Mixture-of-Experts model Kimi K3 on a single Apple Silicon Mac (e.g., M1 Max with 64 GB) at about 16 seconds per token, using exact, reproducible inference with local or streaming expert loading.

AI 与机器学习大语言模型
304
mereyabdenbekuly-ctrl
精选
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI 与机器学习AI 智能体
859
0xwilliamortiz
精选
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI 与机器学习大语言模型
577