mirror of https://github.com/allaunthefox/Research-Stack.git synced 2026-07-30 18:56:16 +00:00

History

Brandon Schneider a99e839bab Track remaining source and documentation inventory		2026-05-11 22:18:31 -05:00
..
.codex-plugin	Track remaining source and documentation inventory	2026-05-11 22:18:31 -05:00
posts/babbage-to-babcock	Track remaining source and documentation inventory	2026-05-11 22:18:31 -05:00
scripts	Track remaining source and documentation inventory	2026-05-11 22:18:31 -05:00
.mcp.json	Track remaining source and documentation inventory	2026-05-11 22:18:31 -05:00
README.md	Track remaining source and documentation inventory	2026-05-11 22:18:31 -05:00

README.md

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.