AI RSS Generator: a tool to convert web content into RSS feeds via AI

General Introduction

AI RSS is an innovative tool that converts web content into RSS feeds through AI technology. It consists of two main parts: a browser plug-in and a server-side. The browser plugin allows users to select lists from web pages and generate Structured Data Description (SDD) files, while the server-side reads the SDD files, crawls the web page content according to the configuration and generates RSS feeds. The tool supports Chrome and Edge browsers and offers two server deployment options: Vercel and Docker.Users need to sign up for an OpenAI, API2D, or SillconFlow account and obtain an API Key to analyze web content using AI.

Function List

• Browser plug-ins: Select the list in the web page and generate the SDD file.
• server-side: Read SDD files and generate RSS feeds.
• Vercel deployment: Supports one-click deployment to the Vercel platform.
• Docker Deployment: Provides both Docker Compose and direct use of Docker commands.
• API Support: Provide API interfaces to get RSS Feed, add SDD configuration and get RSS Feed list.

Using Help

Installation of browser plug-ins

1. preliminary: Sign up for an OpenAI, API2D or SillconFlow account and get an API Key.
2. Download plug-ins: Visit the Releases page to download the plugin package.
3. Unzip the plug-in package: Unzip the downloaded plugin package.
4. Loading Plug-ins::
   • Chrome: Openchrome://extensions/page, click "Load Extracted Extensions" and select the extracted folder.
   • Edge browser: openedge://extensions/page, click "Load Extracted Extensions" and select the extracted folder.

Server deployment

Vercel deployment

1. Click on the "Deploy with Vercel" button.: Click the "Deploy with Vercel" button on the GitHub page.
2. Setting environment variables::
   • ADD_KEY: Set the API access key for adding RSS.
   • CACHE_MINUTES: Set the cache time in minutes.
3. Creating and Connecting to a Blob Store::
   • Go to the Vercel project console after deployment is complete.
   • Go to the "Storage" tab and click "Create Blob Store".
   • Select the newly created Blob storage in the project's storage tab and click "Connect to Project".
4. caveat: If the homepage still shows "blob" after connecting to storage, it will be displayed as "blob".storageconfigured: false", please go to the Vercel console and redeploy once.

Docker Deployment

1. Using Docker Compose (recommended)::
   • Create a working directory and enter it:mkdir -p ai-rss-server && cd ai-rss-serverThe
   • Download the Docker Compose file:wget https://raw.githubusercontent.com/easychen/ai-rss/master/server/docker-compose.ymlThe
   • establish.envfile and add environment variables:ADD_KEY=your_api_key(math.) genusCACHE_MINUTES=60The
   • Start Docker Compose:docker-compose up -dThe
2. Use the Docker command directly::
   • Download the Docker image:docker pull easychen/ai-rss-server:latestThe
   • Run the Docker container:docker run -d --name ai-rss-server -e ADD_KEY=your_api_key -e CACHE_MINUTES=5 easychen/ai-rss-server:latestThe

Using the API

1. Get RSS Feed::
   • Interface:GET /rss/:name
   • Parameters:name(Unique identifier for RSS feed)
   • Back to: RSS XML content
2. Adding SDD Configuration::
   • Interface:POST /add-sdd
   • Header:Content-Type: application/json(math.) genusX-Add-Key: your_api_key
   • Request body: JSON object containing SDD configuration
   • Return to Example:{ "success": true, "key": "Generated unique key", "rss_url": "/rss/unique_key" }
3. Get RSS Feed List::
   • Interface:GET /list
   • Authorization: API key needs to be provided via Header or URL parameter
   • Return to Example:{ "success": true, "total": 2, "items": [ { "key": "unique_key1", "title": "Feed Title", "url": "Original Page URL", "rss_url": "RSS feed URL", "favicon": "Site Icon URL " } ] }