mastodon-ingest

Fetch Mastodon posts with filters and write markdown pages to the vault.

9|1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/lmorchard/decafclaw --skill mastodon-ingest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mastodon-ingest
Source: https://github.com/lmorchard/decafclaw/tree/main/contrib/skills/mastodon-ingest
Command: npx skills add https://github.com/lmorchard/decafclaw --skill mastodon-ingest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mastodon-to-markdown.

What problem does it solve?

Fetch Mastodon posts and record interesting content into the vault.

Core Features & Use Cases

  • Automatic ingestion of posts from a Mastodon instance
  • Filter posts (exclude boosts/replies) and store to vault with sources
  • Create wiki pages under agent/pages/mastodon with inter-page links

Quick Start

Ingest Mastodon posts by running fetch.sh with your Mastodon server and access token configured in the environment.

Frequently Asked Questions about mastodon-ingest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically save Mastodon posts to my vault?

To ingest Mastodon posts into your vault, configure your MASTODON_SERVER and MASTODON_ACCESS_TOKEN environment variables, then run the fetch script to pull and save posts as markdown wiki pages.

What do I need to set up before ingesting Mastodon posts?

You need a configured MASTODON_SERVER and MASTODON_ACCESS_TOKEN, plus the mastodon-to-markdown binary dependency, to start fetching and recording Mastodon posts into your vault.

Can I filter out boosts and replies when saving Mastodon posts?

Yes, the ingestion process applies filters to exclude boosts and replies, ensuring only original post content is recorded into your vault's knowledge management system.

How does incremental fetching work for Mastodon content?

The ingestion script tracks last-run state to perform incremental updates, fetching only new Mastodon posts since the previous run and writing them under agent/pages/mastodon.

Does ingesting Mastodon posts create linked wiki pages?

Yes, the ingestion process creates wiki pages under the agent/pages/mastodon directory, complete with a sources section and inter-page links connecting the saved Mastodon content.

What's the best way to archive social media content for knowledge management?

Using an automated ingestion script to fetch and convert Mastodon posts into markdown wiki pages provides a structured, incremental way to archive social media content into a searchable vault.