Fetcher: save web articles

The fetcher saves web articles into your Alexandria knowledge base. Given a URL, it extracts article content and metadata, converts the body to Markdown, and creates a tagged note.

Building

cargo build -p alexandria-fetcher

The binary is called akb-fetcher.

Usage

Basic

akb-fetcher https://example.com/article

With explicit workspace path

akb-fetcher https://example.com/article --akb-path ~/my-kb

Verbose mode

akb-fetcher -v https://example.com/article

Workspace resolution

akb-fetcher finds your workspace in this order:

--akb-path flag - if provided, uses this path directly
Current directory - if it contains notes/, media/, trash/ subdirectories
Alexandria config - reads ~/.config/alexandria/config.json for a saved workspace_path
Error - asks you to specify --akb-path

What gets extracted

Field	Source (priority order)
Title	`og:title` → `twitter:title` → `<title>` → `<h1>`
Body	Readability extraction → Markdown conversion
Author	`meta[name=author]` → `meta[property=article:author]`
Published date	`meta[property=article:published_time]` → `meta[name=date]`
Keywords	`meta[name=keywords]` (comma-separated)
Original URL	The URL you passed in

The `Fetched Articles` tag

Each fetched article is tagged with Fetched Articles. This tag is created automatically on first use with these properties:

description (string) - user-provided description or notes
original-url (string) - source URL
author (string) - article author
keywords (string) - comma-separated keywords
article-published-on (string) - publication date

You can search and filter fetched articles with this tag.