К основному содержанию
скилл CX Codex

substack — скилл для Claude Code: чтение и публикация в Substack

Скилл ведёт ваш настоящий аккаунт Substack через логин-куки: показывает основную публикацию, выгружает посты со статистикой и публикует новый материал.

Apache-2.0 207 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill substack -a claude-code
Открыть на GitHub

Что делает substack

Скилл работает с Substack под вашей учётной записью: куки логина вы снимаете расширением ACE, а коннектор отдаёт их скрипту в переменной SUBSTACK_COOKIES. Официального публичного API для записи у Substack нет, поэтому запросы идут на те же внутренние веб-эндпоинты, что и у самого сайта.

Внутри один файл — scripts/substack.py, ему хватает стандартной библиотеки Python. Команда whoami показывает аккаунт и основную публикацию, articles --limit 20 выводит опубликованные посты со статистикой, а publish принимает Markdown и переводит его в блоки ProseMirror: заголовки, списки, код и ссылки становятся настоящим форматированием Substack.

Публикация закрыта подтверждением. Без --confirm последним аргументом команда только печатает план и ничего не пишет, поэтому сначала прогоняйте dry-run. С --draft-only пост остаётся черновиком в дашборде и возвращает edit_url. Живая публикация не рассылает письма, пока не добавлен --send-email, а эта рассылка необратима. Просроченные куки дают 401 или 403 — тогда аккаунт переподключают на studio.acedata.cloud/console/connectors.

Какие задачи решает

  • проверить, под каким аккаунтом Substack работают сохранённые куки
  • выгрузить опубликованные посты со статистикой в чат
  • собрать черновик из Markdown и получить ссылку на редактор
  • опубликовать заметку на вебе, не трогая подписчиков
  • разослать выпуск по явному запросу

Примеры запросов агенту

  • Покажи, кто залогинен в Substack и какая у меня основная публикация
  • Выведи последние 20 постов со статистикой
  • Опубликуй post.md как черновик, письма не отправляй

Как установить substack

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill substack -a claude-code

2Вручную: положить файлы

~/.claude/skills/substack/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/substack/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о substack

Как установить substack в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill substack -a claude-code, после этого скилл окажется по пути ~/.claude/skills/substack/SKILL.md.

Что делает substack?

Показывает аккаунт и основную публикацию, перечисляет посты со статистикой и публикует новый материал из Markdown. Запросы идут от вашего имени через куки, снятые расширением ACE.

Что будет, если куки протухнут?

Чтение вернёт 401 или 403, и аккаунт нужно переподключить на studio.acedata.cloud/console/connectors. Запись скрипт не повторяет.

Исходный текст

SKILL.md · Apache-2.0
---
name: substack
description: Read and publish on Substack (substack.com) with the user's own login cookies (BYOC) — show who they are and their primary publication, list their published posts with stats, and publish a new post / newsletter. Use when the user mentions Substack, "my Substack", their newsletter, or publishing a post to Substack.
when_to_use: |
  Trigger for anything on the user's Substack account driven by their own login
  cookie: show who they are and their primary publication, list their published
  posts, or publish a new post / newsletter. This acts as the user's real
  account, so writes are gated behind an explicit confirmation and never email
  subscribers unless asked.
connections: [substack]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

# substack — read & publish on Substack via your own cookies

Drives the user's **real** Substack account through the same internal web API
the site uses (Substack has no official public write API), authenticated by the
login cookie they captured with the ACE extension. No browser, no third-party
deps — just `urllib`. The publish flow mirrors the community `python-substack`
library: **create draft → prepublish → publish**.

The connector injects the cookie jar as an env var:

- `SUBSTACK_COOKIES` — a JSON array of cookies (`substack.sid`, `substack.lli`,
  …). **Secret — never echo or print it.** Substack authenticates writes with
  the session cookie alone (no CSRF token header needed).

## CLI

The skill ships [`scripts/substack.py`](scripts/substack.py) — self-contained, stdlib only.

```sh
# $SKILL_DIR can point at another skill loaded this turn — anchor on our own
# script, and re-run this at the top of every Bash block (fresh shell each time).
SUB="$SKILL_DIR/scripts/substack.py"; [ -f "$SUB" ] || SUB=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/substack.py' 2>/dev/null | head -1)
[ -f "$SUB" ] || { echo "substack script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
python3 "$SUB" whoami                     # who is logged in + primary publication
python3 "$SUB" articles --limit 20        # my published posts + stats
```

## Verify the connection first

```sh
SUB="$SKILL_DIR/scripts/substack.py"; [ -f "$SUB" ] || SUB=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/substack.py' 2>/dev/null | head -1)
python3 "$SUB" whoami
# → {"user_id": ..., "name": "...", "handle": "...", "publication": "...", "publication_url": "https://<sub>.substack.com"}
```

On an auth error the cookie is expired — have the user reconnect at
<https://studio.acedata.cloud/console/connectors>. Do **not** loop-retry.

## Publishing — GATED (dry-run unless trailing `--confirm`)

`publish` writes to the user's real account. Content is **Markdown**, converted
to Substack's ProseMirror blocks: `#`..`######`→heading, ```` ``` ````→code
block, `>`→blockquote, `-`/`*`/`1.`→lists, `---`→horizontal rule, everything else
→paragraphs. Inline **bold**, *italic*, `code`, ~~strike~~, and `[links](url)`
render as real Substack formatting; bare `https://…` URLs are auto-linked.

Without a trailing `--confirm` it dry-runs. `--confirm` is honored **only as the
last argument**. Always show the dry-run, get an explicit "yes", then re-run.

```sh
SUB="$SKILL_DIR/scripts/substack.py"; [ -f "$SUB" ] || SUB=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/substack.py' 2>/dev/null | head -1)
# dry-run (shows the plan, writes nothing)
python3 "$SUB" publish --title "Title" --content-file post.md

# private draft (visible only in the user's dashboard)
python3 "$SUB" publish --title "Title" --content-file post.md --draft-only --confirm

# go LIVE on the web (does NOT email subscribers)
python3 "$SUB" publish --title "Title" --content-file post.md --confirm

# go LIVE and email subscribers (use only when the user explicitly asks)
python3 "$SUB" publish --title "Title" --content-file post.md --send-email --confirm
```

- `--draft-only` stops at a draft — **default to this** unless the user asked to
  go live. Returns an `edit_url` to review in the Substack editor.
- Publishing **does NOT email subscribers** unless `--send-email` is passed.
  Emailing a newsletter is irreversible and hits every subscriber's inbox —
  never add `--send-email` without an explicit request.
- `--subtitle` sets the post subtitle; `--audience` is one of
  `everyone` (default, free/public), `only_paid`, `founding`, `only_free`.

## Gotchas

- **This is the user's real Substack account.** Confirm before any publish, and
  keep `--draft-only` as the safe default.
- **`--send-email` blasts the whole subscriber list** and cannot be undone — opt
  in only on explicit request.
- Substack sits behind Cloudflare; an occasional 403/429 on a read is transient —
  the CLI auto-retries reads once. A *persistent* 401/403 means the cookie is
  genuinely expired (reconnect); the CLI never retries a write.
- **Never print `SUBSTACK_COOKIES`** — it is full account access.
- **ToS**: acts only on the user's own account with their own captured cookie.


## Record the output

After you successfully publish and obtain the live result URL, call the built-in
`publish_artifact` tool ONCE so the user can track this deliverable in **My Outputs**:

```
publish_artifact(kind="article", channel="substack", title="<title>", url="<the REAL returned URL>", status="delivered")
```

Use the real returned URL — never fabricate one. Call it once per published item,
only after delivery is confirmed; skip it (or use `status="failed"`) if publishing failed.
See `_shared/artifacts.md`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
Substack MCP Server marcomoauro MCP-сервер для публикации статей, сегментации подписчиков и чтения аналитики Substack прямо из диалога с ассистентом. CX Codex +1 ★ 95звёзд репо substack-ghostwriting samber Скилл substack-ghostwriting пишет и адаптирует выпуски рассылок и статьи для Substack с подбором авторского тона. Помогает тестировать идеи через Notes и оформлять посты под конверсию в подписчиков. CX Codex +1 5 300установок Substack by Cotlet cotletdev MCP-сервер Substack by Cotlet для Claude Code: публикует посты из Markdown, управляет заметками, комментариями, подписчиками и статистикой Substack. CX Codex +1 ★ 6звёзд репо publish-substack-article sugarforever Скилл publish-substack-article для Claude Code, который переносит Markdown-статью в Substack как черновик. Конвертирует разметку в HTML и вставляет в редактор через буфер обмена, публиковать не спешит. CX Codex +1 611установок substack-expert ft.ia.br Скилл substack-expert помогает готовить Substack-публикации: выстраивает структуру, SEO-метаданные, вовлечение и путь от бесплатной подписки к платной. CX Codex +1 ★ 141звёзд репо newsletter OpenClaudia Скилл newsletter помогает планировать контент рассылки, растить базу подписчиков и настраивать монетизацию. Пригодится при запуске издания на Substack или Beehiiv. CX Codex +1 499установок

Из того же набора67

Весь набор →
onepage-pdf Скилл onepage-pdf рендерит HTML-документ в один непрерывный высокий PDF-лист без разрывов страниц через headless Chrome и обрезает пустоту с помощью PyMuPDF. CX Codex +1 214установок devto Публикует статьи на dev.to, обновляет посты и собирает статистику просмотров и реакций через Forem API v1 прямо из терминала. CX Codex +1 213установок reddit Ищет обсуждения на Reddit, читает правила сабреддитов, отвечает и публикует посты. Работает с тредами и профилем через OAuth или cookies. CX Codex +1 212установок cos-upload Скилл cos-upload загружает локальные файлы в CDN AceData Cloud и возвращает публичную ссылку для передачи в другие API. CX Codex +1 211установок discord Интегрирует аккаунт Discord с ИИ-агентом: читает профиль и список серверов по OAuth либо отправляет сообщения через токен пользователя. CX Codex +1 189установок telegram Управляет личным аккаунтом Telegram через Telethon и MTProto. Помогает читать непрочитанные сообщения, искать переписки, скачивать медиа и отправлять ответы. CX Codex +1 189установок google-search-console Скилл тянет данные Google Search Console через API v1: запросы, страницы, CTR, позиции, сайты, карты сайта и проверку индексации. CX Codex +1 188установок microsoft-excel Читает и правит рабочие книги Excel в OneDrive и SharePoint через Microsoft Graph: диапазоны, таблицы, листы. Токен нужен в $MICROSOFT_EXCEL_TOKEN. CX Codex +1 187установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой