Skills rsshub-route-generator

RSSHub 路由生成器

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/benzking/rsshub-route-generator" ~/.claude/skills/clawdbot-skills-rsshub-route-generator && rm -rf "$T"

manifest: skills/benzking/rsshub-route-generator/SKILL.md

source content

RSSHub 路由生成器

深度分析网站结构，生成 RSSHub 路由代码

技能描述

本技能用于分析任意网站结构，并生成符合 RSSHub 规范的路由代码文件。生成的路由支持：

栏目列表 RSS
全文 RSS（可选）
RSSHub Radar 规则

触发词

当用户发送以下内容时激活本技能：

"生成 RSSHub 路由"
"帮我创建 RSS"
"为网站生成 RSS 订阅"
"制作 RSSHub 路由"
"生成 RSS 路由"
任意网站 URL（将自动检测并询问是否需要生成 RSSHub 路由）

执行逻辑

第一步：网站深度分析

页面结构探测
- 使用
```
web_fetch
```
  获取页面 HTML 内容
- 识别文章列表容器（常见选择器：
```
ul
```
  、
```
div.list
```
  、
```
div.news-list
```
  、
```
article
```
  ）
- 识别标题元素（
```
h1
```
  -
```
h6
```
  、
```
a
```
  、
```
div.title
```
  ）
- 识别日期元素（
```
time
```
  、
```
span.date
```
  、
```
[datetime]
```
  ）
- 识别分类标签（
```
span.category
```
  、
```
a.tag
```
  ）
栏目识别
- 扫描导航菜单中的栏目链接
- 识别侧边栏分类
- 识别面包屑导航
链接模式分析
- 分析内链路径模式（如
```
/news/2024/01/xxx.html
```
  ）
- 识别分页结构
- 确定详情页 URL 格式

第二步：RSSHub 路由生成

根据分析结果生成 TypeScript 代码文件，遵循以下规范：

import { Route } from '@/types';
import got from '@/utils/got';
import { load } from 'cheerio';
import { parseDate } from '@/utils/parse-date';

export const route: Route = {
    path: '/{category}',
    categories: ['{category}'],
    example: '/{site}/{category}',
    parameters: {
        category: '分类名称，默认为 all',
    },
    features: {
        requireConfig: false,
        requirePuppeteer: false,
        antiCrawler: false,
        supportBT: false,
        supportPodcast: false,
        supportScihub: false,
    },
    radar: [
        {
            source: ['{domain}/'],
            target: '/{category}',
        },
    ],
    name: '{网站名称}',
    maintainers: [],
    handler,
    url: '{domain}',
    description: `{网站描述}`,
};

async function handler(ctx) {
    const category = ctx.req.param('category') || 'all';
    const baseUrl = '{website_url}';
    
    // 构建请求 URL
    const url = category === 'all' 
        ? `${baseUrl}/` 
        : `${baseUrl}/${category}/`;
    
    // 获取页面内容
    const response = await got({ method: 'get', url });
    const $ = load(response.data);
    
    // 解析文章列表
    const items = $('{list_selector}').map((_, element) => {
        const $el = $(element);
        return {
            title: $el.find('{title_selector}').text().trim(),
            link: new URL($el.find('{link_selector}').attr('href'), baseUrl).href,
            pubDate: parseDate($el.find('{date_selector}').text().trim(), 'YYYY-MM-DD'),
            category: $el.find('{category_selector}').text().trim(),
        };
    }).get();
    
    // 获取全文内容（可选）
    const fulltextItems = await Promise.all(
        items.slice(0, 10).map(async (item) => {
            try {
                const detailResponse = await got({ method: 'get', url: item.link });
                const detail$ = load(detailResponse.data);
                item.description = detail$('{content_selector}').html();
                return item;
            } catch {
                return item;
            }
        })
    );
    
    return {
        title: '{website_title}',
        link: baseUrl,
        description: '{website_description}',
        item: fulltextItems,
        language: 'zh-cn',
    };
}

第三步：文件输出

生成的路由文件保存到工作目录，命名格式：

主路由：
```
rsshub-routes/{domain}/{route-name}.ts
```
命名空间：
```
rsshub-routes/{domain}/namespace.ts
```
（如需）

输出格式

1. 网站分析报告

## 网站结构分析

### 基本信息
- 域名：{domain}
- 网站标题：{title}
- 语言：{language}

### 栏目结构
| 栏目名 | URL 模式 | 列表选择器 |
|--------|----------|-----------|
| 栏目1 | /news/ | div.news-list li |
| 栏目2 | /notice/ | ul.article-list li |

### 文章结构
- 标题选择器：{title_selector}
- 链接选择器：{link_selector}
- 日期选择器：{date_selector}
- 分类选择器：{category_selector}
- 内容选择器：{content_selector}

### 生成路由
```typescript
{generated_code}


### 2. 路由文件

生成完整的 `.ts` 文件，可直接复制到 RSSHub 项目使用。

## 常见选择器模式参考

### 政府网站
```javascript
// 列表项
$('ul.list li', 'div.news-list li', 'table tr')

// 标题
$('a[title]', 'h3 a', '.title a')

// 日期
$('span.date', '.time', '[datetime]')

// 内容
$('#content', '.article-content', '.main-content')

新闻网站

// 列表
$('.news-list li', '.article-list .item', 'div.container ul li')

// 正文
$('.article-body', '.content', '.post-content')

论坛社区

// 帖子列表
$('.thread-list tr', '.topic-item', '.post-list .item')

// 内容
$('.thread-content', '.post-body', '.message')

最佳实践

缓存策略：使用
```
ofetch
```
并配置合理的缓存 key
并发控制：详情页获取使用
```
pMap
```
控制并发（建议 3-5）
错误处理：每个请求都用 try-catch 包装
去重：使用
```
Map
```
或
```
Set
```
去重
分页：支持
```
limit
```
参数，默认 20 条
全文：可选
```
fulltext
```
参数控制是否获取全文

示例工作流

用户输入：

为 https://example.com/news/ 生成 RSSHub 路由

技能执行：

访问页面，分析结构
识别栏目和列表模式
生成路由代码
输出分析报告和代码文件