Skip to content
Back to search

factcovery-facts

500+ short, sourced fun facts (JSON/CSV) with a JS API, CLI and MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/comficker--factcovery-facts/badge.svg)](/listings/comficker--factcovery-facts)

HTML

<a href="/listings/comficker--factcovery-facts"><img src="/api/listings/comficker--factcovery-facts/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install factcovery-facts

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 112 lines
  1. # factcovery-facts
  2. **English** · [Español](i18n/README.es.md) · [Français](i18n/README.fr.md) · [Deutsch](i18n/README.de.md) · [Português](i18n/README.pt.md) · [Tiếng Việt](i18n/README.vi.md) · [日本語](i18n/README.ja.md) · [한국어](i18n/README.ko.md) · [中文](i18n/README.zh.md)
  3. 500+ short, sourced fun facts as JSON and CSV, with a tiny JavaScript API, a CLI and an MCP server.
  4. Every fact has a one-sentence summary, the source it was checked against, topics, and a link to the full article on [Factcovery](https://www.factcovery.com), a site with a new interesting fact every day.
  5. ```json
  6. {
  7. "id": "octopuses-have-three-hearts-blue-blood-and-neurons-throughout-their-arms",
  8. "title": "Octopuses Have Three Hearts, Blue Blood and Most of Their Neurons in Their Arms",
  9. "summary": "An octopus has three hearts, blue blood and a nervous system in which most neurons sit outside the brain.",
  10. "topics": [
  11. "biology",
  12. "marine-life",
  13. "zoology",
  14. "neuroscience"
  15. ],
  16. "source": "https://en.wikipedia.org/wiki/Octopus",
  17. "factcovery": "https://www.factcovery.com/facts/octopuses-have-three-hearts-blue-blood-and-neurons-throughout-their-arms"
  18. }
  19. ```
  20. ## Topics
  21. | Topic | Facts | JSON | Read online |
  22. |---|---:|---|---|
  23. | History | 61 | [`history.json`](data/topics/history.json) | [History facts](https://www.factcovery.com/topics/history) |
  24. | Marine Life | 40 | [`marine-life.json`](data/topics/marine-life.json) | [Marine Life facts](https://www.factcovery.com/topics/marine-life) |
  25. | Science | 40 | [`science.json`](data/topics/science.json) | [Science facts](https://www.factcovery.com/topics/science) |
  26. | Animals | 38 | [`animals.json`](data/topics/animals.json) | [Animals facts](https://www.factcovery.com/topics/animals) |
  27. | Space | 35 | [`space.json`](data/topics/space.json) | [Space facts](https://www.factcovery.com/topics/space) |
  28. | Ocean | 20 | [`ocean.json`](data/topics/ocean.json) | [Ocean facts](https://www.factcovery.com/topics/ocean) |
  29. | Hedgehogs | 18 | [`hedgehogs.json`](data/topics/hedgehogs.json) | [Hedgehogs facts](https://www.factcovery.com/topics/hedgehogs) |
  30. | Lion | 18 | [`lion.json`](data/topics/lion.json) | [Lion facts](https://www.factcovery.com/topics/lion) |
  31. | Owls | 18 | [`owls.json`](data/topics/owls.json) | [Owls facts](https://www.factcovery.com/topics/owls) |
  32. | Platypus | 18 | [`platypus.json`](data/topics/platypus.json) | [Platypus facts](https://www.factcovery.com/topics/platypus) |
  33. | Sharks | 18 | [`sharks.json`](data/topics/sharks.json) | [Sharks facts](https://www.factcovery.com/topics/sharks) |
  34. | Tiger | 18 | [`tiger.json`](data/topics/tiger.json) | [Tiger facts](https://www.factcovery.com/topics/tiger) |
  35. | Bee | 17 | [`bee.json`](data/topics/bee.json) | [Bee facts](https://www.factcovery.com/topics/bee) |
  36. | Cat | 17 | [`cat.json`](data/topics/cat.json) | [Cat facts](https://www.factcovery.com/topics/cat) |
  37. | Dinosaurs | 17 | [`dinosaurs.json`](data/topics/dinosaurs.json) | [Dinosaurs facts](https://www.factcovery.com/topics/dinosaurs) |
  38. | Mars | 17 | [`mars.json`](data/topics/mars.json) | [Mars facts](https://www.factcovery.com/topics/mars) |
  39. | Moon | 17 | [`moon.json`](data/topics/moon.json) | [Moon facts](https://www.factcovery.com/topics/moon) |
  40. | Butterfly | 16 | [`butterfly.json`](data/topics/butterfly.json) | [Butterfly facts](https://www.factcovery.com/topics/butterfly) |
  41. | Christmas | 16 | [`christmas.json`](data/topics/christmas.json) | [Christmas facts](https://www.factcovery.com/topics/christmas) |
  42. | Earth | 16 | [`earth.json`](data/topics/earth.json) | [Earth facts](https://www.factcovery.com/topics/earth) |
  43. | Japan | 16 | [`japan.json`](data/topics/japan.json) | [Japan facts](https://www.factcovery.com/topics/japan) |
  44. | Canada | 15 | [`canada.json`](data/topics/canada.json) | [Canada facts](https://www.factcovery.com/topics/canada) |
  45. | Engineering | 15 | [`engineering.json`](data/topics/engineering.json) | [Engineering facts](https://www.factcovery.com/topics/engineering) |
  46. | Giraffe | 15 | [`giraffe.json`](data/topics/giraffe.json) | [Giraffe facts](https://www.factcovery.com/topics/giraffe) |
  47. | Penguins | 15 | [`penguins.json`](data/topics/penguins.json) | [Penguins facts](https://www.factcovery.com/topics/penguins) |
  48. | Sports | 15 | [`sports.json`](data/topics/sports.json) | [Sports facts](https://www.factcovery.com/topics/sports) |
  49. | Human Body | 14 | [`human-body.json`](data/topics/human-body.json) | [Human Body facts](https://www.factcovery.com/topics/human-body) |
  50. | Mexico | 14 | [`mexico.json`](data/topics/mexico.json) | [Mexico facts](https://www.factcovery.com/topics/mexico) |
  51. | Volcano | 14 | [`volcano.json`](data/topics/volcano.json) | [Volcano facts](https://www.factcovery.com/topics/volcano) |
  52. | Ancient Egypt | 13 | [`ancient-egypt.json`](data/topics/ancient-egypt.json) | [Ancient Egypt facts](https://www.factcovery.com/topics/ancient-egypt) |
  53. | Festivals | 12 | [`festivals.json`](data/topics/festivals.json) | [Festivals facts](https://www.factcovery.com/topics/festivals) |
  54. | Octopus | 11 | [`octopus.json`](data/topics/octopus.json) | [Octopus facts](https://www.factcovery.com/topics/octopus) |
  55. | World War Ii | 8 | [`world-war-ii.json`](data/topics/world-war-ii.json) | [World War Ii facts](https://www.factcovery.com/topics/world-war-ii) |
  56. ## Install
  57. ```bash
  58. npm install factcovery-facts
  59. ```
  60. ## Usage
  61. ```js
  62. import { randomFact, factOfTheDay, factsByTopic, search } from 'factcovery-facts'
  63. randomFact() // any fact
  64. randomFact('space') // a random space fact
  65. factOfTheDay() // same fact for everyone today
  66. factsByTopic('penguins')
  67. search('octopus')
  68. ```
  69. ```bash
  70. npx factcovery-facts # random fact
  71. npx factcovery-facts today # fact of the day
  72. npx factcovery-facts topics
  73. ```
  74. ## Data files
  75. - `data/facts.json` · `data/facts.csv`
  76. - `data/index.json`
  77. - `data/topics/<topic>.json`
  78. - CDN: `https://cdn.jsdelivr.net/npm/factcovery-facts/data/facts.json`
  79. ## MCP server
  80. Use the facts from Claude, Cursor or any MCP client:
  81. ```json
  82. { "mcpServers": { "factcovery-facts": { "command": "npx", "args": ["-y", "-p", "factcovery-facts", "factcovery-facts-mcp"] } } }
  83. ```
  84. Tools: `random_fact`, `fact_of_the_day`, `search_facts`, `facts_by_topic`, `get_fact`, `list_topics`.
  85. ## About Factcovery
  86. [Factcovery](https://www.factcovery.com) publishes short, sourced facts about animals, space, history, science and the human body. Browse [random facts](https://www.factcovery.com/random), [weird facts](https://www.factcovery.com/weird-facts) or [funny facts](https://www.factcovery.com/funny-facts), or get one fact a day with the [Android app](https://play.google.com/store/apps/details?id=com.factcovery.app).
  87. Found a wrong fact? [Open an issue](https://github.com/comficker/factcovery-facts/issues/new?template=wrong-fact.md) with a better source.
  88. ## License
  89. Code: MIT. Data: CC BY 4.0. Please credit: **Facts by [Factcovery](https://www.factcovery.com)**. [SOURCES.md](SOURCES.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.