Site Feeds

This skill helps AI agents fetch updates and content from websites using the airsstool CLI.

When to Use This Skill

Use this skill when the user:

• - Wants to see the latest content from a website or platform (YouTube, GitHub, Instagram, Reddit, etc.)
• Asks "What's new on..." or "Show me updates from..."
• Wants to track trending content, news, blog posts, videos, etc.
• Needs to monitor specific users, topics, or categories on platforms
• Wants to set up recurring checks for content updates
• Asks about what content/information can be fetched from a specific website

Installation

Before using airsstool, ensure the following prerequisites are met. Ask the user for permission when needed (e.g., deploying RSSHub via Docker, choosing a Python environment, setting environment variables).

1. Deploy RSSHub (if not already running)

Check if the user already has a running RSSHub Docker container. If not:

1. 1. Inform the user that RSSHub needs to be locally deployed
2. After user confirmation, create a rsshub folder in a suitable location
3. Follow the 'Docker Compose Deployment' guide in RSSHub deployment docs to download the docker-compose.yml in the rsshub folder
4. Create a .env file for environment variables
5. Modify docker-compose.yml to add Puppeteer support if needed, and add env_file: - .env to the rsshub service
6. Run INLINECODE7

2. Install airsstool

Follow the instructions at https://github.com/heqi201255/airsstool

Ask the user if they want to install Python dependencies in a specific virtual environment. If yes, remember to activate that environment before each use.

3. Initialize Database

After installation, run the init command (takes ~1min):

CODEBLOCK0

This creates the database at ~/.airsstool/airsstoolDB.db by default. Use --db-path for a custom location.

After installation is complete and verified working, you may delete this installation section in this file.

Available CLI Commands

Init Command

Command	Purpose
INLINECODE10	Initialize database (first time setup)
INLINECODE11

Initialize with custom database path | | airsstool init --force | Force recreate database |

Discovery Commands

Command	Purpose	Example Usage
INLINECODE13	List all content categories	"What categories are available?"
INLINECODE14

List websites by category | "Show me social media websites" | | airsstool list routes <website> | Find available feeds for a website | "What feeds does GitHub have?" | | airsstool check <website> <route> | Get feed details & parameters | "How to use GitHub trending?" |

Fetch Commands

Command	Purpose	Example Usage
INLINECODE17	Fetch content from a feed	"Get GitHub trending"
INLINECODE18

Fetch all feeds in a subscription | "Get all my tech news feeds" |

Subscription Commands

Command	Purpose	Example Usage
INLINECODE19	List all users	"Who has subscriptions?"
INLINECODE20

List user's subscription groups | "Show alice's subscriptions" | | airsstool list paths -U <user> -S <name> | List paths in a subscription | "What's in tech_news group?" | | airsstool add-subscription -U <user> -S <name> | Create subscription group | "Create a news subscription" | | airsstool subscribe -U <user> -S <name> -P <path> -D <desc> | Add path to subscription | "Subscribe to GitHub trending" | | airsstool unsubscribe -U <user> -S <name> | Delete subscription group | "Delete my tech_news group" | | airsstool remove-subscription -U <user> -S <name> -P <path> | Remove path from subscription | "Remove GitHub trending from tech_news" |

Common Workflows

Finding a Feed

1. 1. Browse by category if you know the type:

CODEBLOCK1

1. 2. Search by website name (fuzzy search supported):

CODEBLOCK2

1. 3. Check feed details for parameters:

CODEBLOCK3

Fetching Content

Simple fetch:
CODEBLOCK4

With filters:
CODEBLOCK5

With format conversion:
CODEBLOCK6

Pagination:
CODEBLOCK7

Managing Subscriptions

Create a subscription group:
CODEBLOCK8

Add feeds to subscription:
CODEBLOCK9

Fetch subscription:
CODEBLOCK10

Fetch Parameters

List Options

Option	Description
INLINECODE26	Filter websites by category
INLINECODE27

Number of results per page (default: 20) | | --page-num N | Page number (default: 1) | | --enable-nsfw | Include NSFW websites in results |

Filter Options

Option	Description
INLINECODE30	Filter title and description (regex)
INLINECODE31

Filter title only | | --filter-description PATTERN | Filter description only | | --filter-author PATTERN | Filter by author | | --filter-category PATTERN | Filter by category | | --filter-time SECONDS | Time range in seconds | | --filterout PATTERN | Exclude from title and description | | --filterout-title PATTERN | Exclude from title | | --filterout-description PATTERN | Exclude from description | | --filterout-author PATTERN | Exclude author | | --filterout-category PATTERN | Exclude category | | --filter-case-sensitive BOOL | Case sensitivity (default: true) |

Output Options

Option	Description
INLINECODE42	Output format: markdown (default), rss, atom, json, rss3. Default is Markdown - don't specify unless needed.
INLINECODE48

Brief text with N chars (>=100) | | --limit N | Limit number of items | | --offset N | Skip first N items (only works with markdown format) |

Tips for Effective Use

1. 1. Fuzzy search works: airsstool list routes gthub will suggest "GitHub"

1. 2. Path format: Always start with /, e.g., INLINECODE53

1. 3. Check route details first: Use airsstool check <website> <route> to understand required parameters

1. 4. Default output is Markdown: Parsed and formatted for readability. Use --format rss for raw RSS.

1. 5. Subscription persistence: Subscriptions are stored in SQLite database for persistence

Example Interactions

User: "Find me some programming news feeds"

CODEBLOCK11

User: "Get the latest trending JavaScript repos"

CODEBLOCK12

User: "Create a subscription for my daily tech reading"

CODEBLOCK13

User: "Remove a specific feed from my subscription"

CODEBLOCK14

User: "Delete my entire subscription group"

⚠️ This action cannot be undone. Ask the user to confirm before proceeding:

CODEBLOCK15

Error Handling

• - If website not found, fuzzy search will suggest alternatives
• If route not found, check website spelling first
• If some websites fail to fetch, use airsstool check <website> <route> to see if there's a RequireConfig note. If so, the website requires environment variables. Search online for how to obtain them and ask the user for help. Once obtained, add them to the .env file and restart the RSSHub service
• If fetch still fails, the path may be invalid or the RSSHub instance may be down
• Use --force flag in airsstool subscribe to skip connectivity check