https://github.com/pinjasaur/meed
Get Medium RSS feeds as JSON.
https://github.com/pinjasaur/meed
Last synced: about 1 year ago
JSON representation
Get Medium RSS feeds as JSON.
- Host: GitHub
- URL: https://github.com/pinjasaur/meed
- Owner: Pinjasaur
- Created: 2018-11-15T15:37:06.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-12-10T05:24:05.000Z (over 4 years ago)
- Last Synced: 2025-04-15T06:08:18.752Z (about 1 year ago)
- Language: JavaScript
- Homepage: https://meed.js.org/
- Size: 255 KB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://travis-ci.org/Pinjasaur/meed)
Modern JS library for getting Medium RSS feeds (user, publcation, topic, or tag)
as JSON. Targets modern browsers / Node.js with an API that utilizes
[`fetch`][fetch] along with [`async` / `await`][async].
Check out the [Meed docs][docs] for details.
## What
Get Medium RSS feeds as JSON. Check out [Ghosts/medium-feed][mf] because it may
suit your needs better.
## Why
Because [@Ghosts](https://github.com/Ghosts) was writing [medium-feed][mf]. ¯\\\_(ツ)_/¯
## How
Medium provides basic docs regarding the RSS feeds: https://help.medium.com/hc/en-us/articles/214874118-RSS-feeds
You can get feeds for a user, publication, topic, or tag. Topics can be found at
https://medium.com/topics or via `Meed#topics()`. In general, feeds seem to be
limited to 10 items.
Check out the [Meed docs][docs] for more.
### Install
Via npm or unpkg:
- `npm install meed` / `yarn add meed`
- https://unpkg.com/meed
### Use
In a browser that supports [`fetch`][ciu-fetch] & [`async`/`await`][ciu-async]:
```js
const feed = new Meed()
;(async () => {
const user = await feed.user("Medium")
console.log(user)
})()
```
or in Node.js (bring your own `fetch`):
```js
const Meed = require("meed")
const fetch = require("node-fetch")
const feed = new Meed({ fetch })
;(async () => {
const user = await feed.user("Medium")
console.log(user)
})()
```
### Proxy
For local(host) testing in a browser, you'll probably need a CORS proxy. Here's
a list: https://gist.github.com/jimmywarting/ac1be6ea0297c16c477e17f8fbe51347
You can use one like so:
```js
new Meed({ proxy: "PROXY_URL" })
```
I've had good luck with ~~https://cors-anywhere.herokuapp.com/~~ https://cors.bridged.cc/.
Check out the [Meed docs][docs] for more details.
## Who
[Paul Esch-Laurent](https://github.com/Pinjasaur).
## License
[MIT](https://pinjasaur.mit-license.org/2018).
[mf]: https://github.com/Ghosts/medium-feed
[docs]: https://meed.js.org/
[fetch]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
[async]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function
[ciu-fetch]: https://caniuse.com/#feat=fetch
[ciu-async]: https://caniuse.com/#feat=async-functions