Utilities for exporting Typefully social-set drafts and turning them into local analysis/process-doc drafts.

The exporter reads TYPEFULLY_API_KEY from .env or the environment and does not print the token. The analyzer reads only its caller-supplied local JSON file and makes no credential or network request. Keep exports under .tmp/ because post archives can contain private Typefully URLs, draft text, and unpublished drafts.

Generated analysis and process-document drafts are also private operational data and stay under ignored .tmp/ paths until separately reviewed for promotion. The analyzer omits provider private, share, and edit link metadata from every generated file. If the same exact private link value appears inside otherwise useful post evidence, it is replaced with a fixed neutral omission marker. Wrapper punctuation does not suppress omission, while a distinct, syntactically valid longer public URL remains unchanged.

node scripts/typefully/export-posts.mjs \
  --output .tmp/typefully-export \
  --status all

By default, the exporter discovers all Typefully social sets available to the API key. To restrict the export, pass one or more social-set names, usernames, or ids:

node scripts/typefully/export-posts.mjs \
  --output .tmp/typefully-export \
  --status published \
  --social-set DataTalksClub \
  --social-set Al_Grigor

The export includes:

• social-sets.json: accessible social sets and connected platforms.
• <social-set>-drafts.json: raw draft list and detail responses.
• all-drafts.json: combined raw export.
• posts.jsonl: one normalized row per platform post.
• posts.csv: same normalized rows for spreadsheet analysis.

The normalized rows include both X/Twitter (platform=x) and LinkedIn (platform=linkedin) posts when present in Typefully draft details.

Typefully analytics currently supports X posts only. LinkedIn analytics is not available through the Typefully endpoint tested on 2026-06-29.

node scripts/typefully/export-posts.mjs \
  --output .tmp/typefully-export \
  --status published \
  --include-x-analytics \
  --analytics-start-year 2022

node scripts/typefully/analyze-posts.mjs \
  --input .tmp/typefully-export/all-drafts.json \
  --output .tmp/typefully-analysis

This creates:

• analysis.md
• process-doc-drafts/*.md