Skip to main content

kagi smallweb

Fetch the Kagi Small Web feed - a curated collection of posts from independent websites and personal blogs.

Synopsis

kagi smallweb [OPTIONS]

Description

The kagi smallweb command retrieves the Kagi Small Web feed, which features content from independent websites, personal blogs, and the “small web” - content outside the major platforms and corporate sites. This command requires no authentication and provides a window into independent web publishing.

Authentication

Required: None Works immediately after installation, no tokens needed.

Options

--limit <COUNT>

Number of posts to return. Type: Integer Behavior: forwarded directly to the Small Web feed endpoint when provided Example:
kagi smallweb --limit 10
kagi smallweb --limit 50

Output Format

{
  "xml": "<?xml version=\"1.0\"?><rss>...</rss>"
}

Fields

FieldTypeDescription
xmlstringRaw Small Web RSS/Atom feed body

Examples

Basic Usage

# Get the Small Web feed
kagi smallweb

# Request a smaller feed slice
kagi smallweb --limit 50

# Request fewer posts
kagi smallweb --limit 5

Processing Output

# Save the raw feed to disk
kagi smallweb > smallweb-feed.json

# Extract the XML payload
kagi smallweb | jq -r '.xml' > smallweb.xml

Daily Discovery

#!/bin/bash
# small-web-discovery.sh

echo "🌐 Today's Small Web Discoveries"
echo "================================="
echo ""

kagi smallweb --limit 10 | jq -r '.xml'

Archiving Workflow

#!/bin/bash
# Archive Small Web posts

OUTPUT_DIR="$HOME/smallweb-archive/$(date +%Y/%m)"
mkdir -p "$OUTPUT_DIR"

echo "Fetching Small Web feed..."
kagi smallweb --limit 100 | jq -r '.xml' > "$OUTPUT_DIR/smallweb-$(date +%Y%m%d).xml"

echo "Saved to: $OUTPUT_DIR"

What is the Small Web?

The Small Web refers to:
  • Personal blogs and websites
  • Independent publishers
  • Non-commercial content
  • Content outside major platforms
  • Individual voices and perspectives
Kagi curates this feed to surface quality independent content.

Exit Codes

CodeMeaning
0Success
1Error (network, etc.)

See Also