Feedship Skill

Version: 1.5
For: Claude Code and OpenClaw compatible agents
Description: Manage information feeds, subscribe to RSS/GitHub sources, and search articles

Setup

Before using this skill, install feedship with ML and cloud extras:

CODEBLOCK0

Note: cloudflare extra provides scrapling (HTML fetching); ml extra provides
sentence-transformers + chromadb (semantic search). Both are required for full functionality.

China / Restricted Networks

For environments where PyPI or HuggingFace is not accessible, use mirrors:

CODEBLOCK1

Upgrade

CODEBLOCK2

After installation, verify with: INLINECODE2

First-time setup for semantic search: After installing, run feedship fetch --all
to populate the vector database with article embeddings. Semantic search requires
embeddings to be generated first (chromadb storage).

Commands

feed

Manage RSS/Atom feeds and GitHub release trackers.

feed add

CODEBLOCK3

Add a new feed by URL with automatic provider detection.

Options:

• - --auto-discover/--no-auto-discover — Enable feed auto-discovery (default: enabled)
• INLINECODE5 — Automatically add all discovered feeds (default: off)
• INLINECODE6 — Discovery crawl depth 1-10 (default: 1)
• INLINECODE7 — Feed weight for semantic search (default: 0.3)

Examples:
CODEBLOCK4

feed list

CODEBLOCK5

List all subscribed feeds with status.

Options:

• - -v, --verbose — Show detailed output
• INLINECODE9 — Output in JSON format for programmatic consumption

feed remove

CODEBLOCK6

Remove a subscribed feed by ID.

fetch

CODEBLOCK7

Fetch new articles from subscribed feeds.

Options:

• - --all — Fetch all subscribed feeds
• INLINECODE11 — Max concurrent fetches 1-100 (default: 10)

Examples:

feedship fetch --all
feedship fetch abc12345
feedship fetch abc12345 def67890 --concurrency 20

article

Manage and view fetched articles.

article list

CODEBLOCK9

Options:

• - --limit N — Maximum articles (default: 20)
• INLINECODE13 — Filter by feed ID
• INLINECODE14 — Start date (YYYY-MM-DD)
• INLINECODE15 — End date (YYYY-MM-DD)
• INLINECODE16 — Specific date (can repeat for multiple)
• INLINECODE17 — Output in JSON format for programmatic consumption

article view

CODEBLOCK10

View full article content and metadata.

article open

CODEBLOCK11

Open article in system browser.

article related

CODEBLOCK12

Find semantically related articles.

search

CODEBLOCK13

Search articles using full-text or semantic search.

Options:

• - --limit N — Maximum results (default: 20)
• INLINECODE19 — Filter by feed ID
• INLINECODE20 — Use semantic (vector) search instead of keyword
• INLINECODE21 — Apply Cross-Encoder reranking
• INLINECODE22 — Start date filter
• INLINECODE23 — End date filter
• INLINECODE24 — Specific date filter
• INLINECODE25 — Output in JSON format for programmatic consumption

Examples:

feedship search "machine learning"
feedship search "python news" --semantic
feedship search "updates" --semantic --rerank

discover

CODEBLOCK15

Discover RSS/Atom/RDF feeds on a website without subscribing.

Options:

• - --discover-depth N — Crawl depth 1-10 (default: 1)
• INLINECODE27 — Output in JSON format for programmatic consumption

Examples:
CODEBLOCK16

info

CODEBLOCK17

Display system information, configuration, and storage status.

Options:

• - --json — Output in JSON format for programmatic consumption

Output includes:

• - Version information
• Configuration file location
• Database/storage path
• Feed count and article count
• Installed extras (ml, cloudflare)

Examples:

feedship info
feedship info --json

Output Formats

Tables

INLINECODE29, article list, search, discover output Rich tables:

• - Magenta headers
• Alternating row styles
• Truncated columns with overflow indicators

Panels

INLINECODE33 uses Rich Panel:

• - Title: Article title
• Subtitle: Feed name | Date
• Content: Full article text

Progress Bars

INLINECODE34 uses Rich progress bars showing:

• - Current feed being fetched
• New articles count
• Elapsed time

Common Patterns

Initial Setup

CODEBLOCK19

Daily Workflow

CODEBLOCK20

Feed Management

CODEBLOCK21

Scheduled Fetching (OpenClaw Best Practice)

For automated periodic fetching, use platform-specific schedulers:

macOS (LaunchAgent):
CODEBLOCK22

Linux (systemd timer):
CODEBLOCK23

Cron:
CODEBLOCK24

OpenClaw Cron (every 30 minutes):

openclaw cron add \
  --name "feedship-fetch" \
  --agent agent \
  --cron "*/30 * * * *" \
  --tz Asia/Shanghai \
  --session isolated \
  --message "uv run --with feedship[ml,cloudflare] feedship fetch --all" \
  --timeout-seconds 1800

Optional Dependencies

ML Extra (pip install feedship[ml])

Required for semantic search and related articles:

• - sentence-transformers
• chromadb
• torch

Cloudflare Extra (pip install feedship[cloudflare])

For enhanced web scraping with:

• - browserforge
• playwright
• curl-cffi