RSSHub/website/docs/usage.md

76 lines
1.9 KiB
Markdown

# Getting Started
## Generate an RSS Feed
To subscribe to a Twitter user's timeline, first look at the route document of [Twitter User Timeline](/routes/social-media#twitter-user-timeline).
`/twitter/user/:id` is the route where `:id` is the actual Twitter username you need to replace. For instance, `/twitter/user/DIYgod` with a prefix domain name will give you the timeline of Twitter user DIYgod.
The demo instance will generate an RSS feed at <https://rsshub.app/twitter/user/DIYgod>, use your own domain name when applicable. This feed should work with all RSS readers conforming to the RSS Standard.
You can replace the domain name `https://rsshub.app` with your [self-hosted instance](/install).
RSSHub supports additional parameters such as content filtering and full-text extraction, refer to [Parameters](/parameter) for details.
## Contribute a New Route
Our thriving community is the key to RSSHub's success, we invite everyone to join us and [contribute new routes](/joinus/quick-start) for all kinds of interesting sources.
## Use as a npm Package
Apart from serving as an information source hub, RSSHub is also made compatible with all Node.js projects as an npm Package.
### Install
<Tabs>
<TabItem value="pnpm" label="pnpm" default>
```bash
pnpm add rsshub
```
</TabItem>
<TabItem value="yarn" label="yarnv1">
```bash
yarn add rsshub
```
</TabItem>
<TabItem value="npm" label="npm">
```bash
npm install rsshub --save
```
</TabItem>
</Tabs>
### Usage
```js
const RSSHub = require('rsshub');
RSSHub.init({
// config
});
RSSHub.request('/youtube/user/JFlaMusic')
.then((data) => {
console.log(data);
})
.catch((e) => {
console.log(e);
});
```
For supported configs please refer to the [Configuration Section](/install#configuration-3).
A short example for disabling caching can be written as:
```js
{
CACHE_TYPE: null,
}
```