Ghost-Writer Sync

通过 python3 脚本从 Substack 公开 RSS 和 Ghost Content API 拉取已发布文章，将 HTML 转为 Markdown，按 Obsidian YAML 或 Logseq 属性格式写入本地仓库，并带标题、来源、链接、发布时间、去重 ID 等 frontmatter；也可添加/列出同步源与查看配置。依赖网络与 Ghost API 密钥。

liverock

热度 37.83

最近更新 2026-05-18 11:40:51

分类：知识依赖：代码执行 / 读写文件 / 第三方 API应用场景：笔记整理 / 博客写作 / 工作流 / 自动化脚本 ...

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ghost-writer-sync

Metadata

name: ghost-writer-sync
description: Pulls published blog posts from Substack and Ghost into an Obsidian or Logseq vault for AI-assisted repurposing.
tools: [{"name":"sync_posts","description":"Synchronizes all configured blog sources into the local vault. Fetches new posts from Substack and/or Ghost, converts HTML to Markdown, and writes files with proper frontmatter.","arguments":[{"name":"config","description":"Path to the JSON config file (default: ghost-writer-sync.json).","type":"string","required":false},{"name":"vault","description":"Override vault directory from config.","type":"string","required":false},{"name":"format","description":"Output format — \"obsidian\" (YAML frontmatter) or \"logseq\" (property list).","type":"string","required":false}],"execution":{"command":"python3 {{SKILL_DIR}}/sync.py sync --config \"{{config}}\" --vault \"{{vault}}\" --format \"{{format}}\"","output_format":"markdown"}},{"name":"add_substack","description":"Adds a Substack publication as a sync source. The RSS feed is public so no API key is needed.","arguments":[{"name":"url","description":"Publication URL (e.g. https://example.substack.com).","type":"string","required":true},{"name":"config","description":"Path to the JSON config file.","type":"string","required":false}],"execution":{"command":"python3 {{SKILL_DIR}}/sync.py add-substack --url \"{{url}}\" --config \"{{config}}\"","output_format":"markdown"}},{"name":"add_ghost","description":"Adds a Ghost blog as a sync source. Requires a Ghost Content API key in id:secret format.","arguments":[{"name":"url","description":"Ghost site URL (e.g. https://myblog.ghost.io).","type":"string","required":true},{"name":"api_key","description":"Ghost Content API key (id:secret format).","type":"string","required":true},{"name":"config","description":"Path to the JSON config file.","type":"string","required":false}],"execution":{"command":"python3 {{SKILL_DIR}}/sync.py add-ghost --url \"{{url}}\" --api-key \"{{api_key}}\" --config \"{{config}}\"","output_format":"markdown"}},{"name":"list_sources","description":"Lists all configured blog sources and the current vault path.","arguments":[],"execution":{"command":"python3 {{SKILL_DIR}}/sync.py list --config \"{{config}}\"","output_format":"markdown"}},{"name":"show_config","description":"Displays the current sync configuration.","arguments":[],"execution":{"command":"python3 {{SKILL_DIR}}/sync.py config --config \"{{config}}\"","output_format":"markdown"}}]

Ghost-Writer Sync

Automatically pulls your published blog posts (Substack / Ghost) into your local Obsidian or Logseq vault for AI-assisted repurposing.

How It Works

Blog Source  →  Fetch Posts  →  HTML → Markdown  →  Write to Vault
(Substack RSS / Ghost API)       (stdlib)         (frontmatter + body)

Fetch — Pulls published posts from each configured source
Convert — Transforms HTML content to clean Markdown using a stdlib-only converter
Write — Saves each post as a Markdown file with rich frontmatter in your vault

Supported Sources

Source	Auth	Notes
Substack	None (public RSS)	Reads the `/feed` endpoint
Ghost	Content API key (`id:secret`)	Uses Admin API JWT auth

Output Formats

Format	Frontmatter	Filename
Obsidian	YAML block (`---` delimited)	`{slug}.md`
Logseq	Property list (`key:: value`)	`{date} {slug}.md`

Frontmatter Fields

Every synced post includes:

Field	Description
`title`	Post title
`source`	`substack` or `ghost`
`url`	Original post URL
`published`	Publication date
`synced`	Timestamp of last sync
`post_id`	Stable hash-based ID for dedup
`tags`	(Ghost only) Tag names
`excerpt`	(Ghost only) Post excerpt
`feature_image`	(Ghost only) Hero image URL

Usage

Add a source

# Substack — just the URL
python3 sync.py add-substack --url https://example.substack.com

# Ghost — URL + API key
python3 sync.py add-ghost --url https://myblog.ghost.io --api-key abc123:def456...

Run a sync

python3 sync.py sync --vault /path/to/obsidian-vault

Check config

python3 sync.py list
python3 sync.py config

Repurposing Workflow

Once posts are in your vault, use your AI assistant to:

Rewrite posts as Twitter/X threads
Generate LinkedIn summaries
Create newsletter compilations
Extract key quotes and talking points
Draft follow-up posts based on themes

Posts land as standard Markdown files, so they work with any Obsidian plugin, Logseq graph, or AI tool that reads .md files.