json_feed_filter

Hex.pmHex DocsLicense

em_filter agent for JSON Feed (jsonfeed.org spec v1 and v1.1).

Reads a list of JSON Feed URLs from json_feed_config.json, fetches each feed, and returns items whose title, url or summary matches the search query.

No XML parser needed — pure JSON, lighter than RSS or Atom. Handles both content_text and content_html fields, preferring plain text.

Setup

Rename json_feed_config.json.sample to json_feed_config.json and fill in your feed URLs:

{
    "json_feeds": [
        "https://example.com/feed.json",
        "https://another.com/feed.json"
    ]
}

Usage

Add json_feed_filter to your dependencies, then start it as an OTP application. It registers itself with em_disco automatically on startup.

For a site-specific filter, create a wrapper application that copies its own priv/json_feed_config.json to the working directory before starting json_feed_filter. See tech_blogs_json_feed_filter for a concrete example.