allaun/Research-Stack
1
0
Fork 0
mirror of https://github.com/allaunthefox/Research-Stack.git synced 2026-07-31 03:05:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Research-Stack/5-Applications/plugins/substack-connector/README.md
Brandon Schneider a99e839bab Track remaining source and documentation inventory
2026-05-11 22:18:31 -05:00

1.4 KiB
Raw Blame History

Substack Connector

Repo-local helper for preparing Markdown posts and image assets for Substack.

This is not an official Substack API integration. The default path prepares a clean local bundle for the Substack editor:

  • converts [IMAGE: file.png] placeholders into Markdown images
  • copies local image assets next to the publish bundle
  • emits post.md
  • emits a simple post.html preview
  • provides a minimal MCP-style tool surface for future Codex sessions

An authenticated updater is also available for existing posts when a local Substack cookie string exists in /home/allaun/.substack.env as COOKIES_STRING. It writes a timestamped local backup before updating the remote draft.

CLI

python3 plugins/substack-connector/scripts/prepare_substack_post.py \
  6-Documentation/articles/babbage-to-babcock/article.md

Default output:

6-Documentation/articles/babbage-to-babcock/substack_bundle/

Existing Post Update

/home/allaun/.local/share/substack-env/bin/python \
  plugins/substack-connector/scripts/update_existing_post.py \
  6-Documentation/articles/babbage-to-babcock/substack_bundle/post.md \
  --post-id 196596937

Add --publish only when the updated draft should be pushed live. The publish call uses send=False and share_automatically=False.

Backups are written under substack_bundle/substack_backups/ and ignored by Git.