K
Docs
Building Bots

📚 The Almanac

Your bot, but it knows things. Look up Wikipedia, the weather anywhere on Earth, TV shows and when the next episode airs, movies, anime, manga, books, word meanings, exchange rates, what happened on this day — and every Pokémon.

🎁 Free to unbox · no API keys · works on Interaction Only bots

🧰What's in the box

🔀Found, Missing, Error

Every look-up has three ways out — give each one a reply.

  • Found ✓ — the answer is in the spark you named under Save it as: {{weather.summary}}, {{anime.score}}, {{wiki.url}}…
  • Missing ∅ — nothing matched what they typed. {{weather.query}} still says what it was, so you can tell them.
  • Error ✗— the source couldn't be asked just now (busy, down, or your bot asked for a lot very quickly). {{weather.error}}says why, and it's in your bot's Activity too.
a /weather flowJSON
{
  "nodes": [
    { "id": "look",    "piece": "info.weather", "config": { "place": "{{input.options.city}}", "units": "metric", "as": "weather" } },
    { "id": "found",   "piece": "base.reply",   "config": { "content": "**{{weather.place}}**\n{{weather.summary}}\n\n{{weather.forecast}}" } },
    { "id": "missing", "piece": "base.reply",   "config": { "content": "🗺️ I couldn't find {{weather.query}} — try adding the country.", "ephemeral": true } },
    { "id": "error",   "piece": "base.reply",   "config": { "content": "☁️ The weather service is busy — try again in a minute!", "ephemeral": true } }
  ],
  "edges": [
    { "from": "look", "to": "found",   "port": "found" },
    { "from": "look", "to": "missing", "port": "missing" },
    { "from": "look", "to": "error",   "port": "error" }
  ]
}
✨Pictures
Posters, covers and artwork come back as links — {{movie.image}}, {{pokemon.image}}. Put one in an Embed's Big image or Thumbnail, or hand it to The Darkroom to design a card around it.

📍Finding places

Check the Weather knows about 34,000 towns and cities.

TypeGets you
ParisThe biggest place with that name — Paris, France
Paris, TX · Paris TexasA state, province or country after the name narrows it down
London, Ontario · Portland, MaineWorks for any country's regions
Kiev · Bombay · Cologne · NYCCommon old names, English names and nicknames
JapanA whole country means its biggest city — Tokyo
51.5, -0.12Coordinates, for anywhere at all

You get the weather now, highs and lows for the next 24 hours, a five-day {{weather.forecast}} and the local time there ({{weather.time}}) — so it doubles as a world clock.

🗺️Where answers come from

Free, public sources that need no sign-up — we say thanks by naming them.

PieceSourceLicense
🌐 Look Up on WikipediaWikipedia (29 languages)CC BY-SA
🌦️ Check the WeatherMET Norway — places from GeoNames, built inCC BY 4.0
📺 Find a TV ShowTVmazeCC BY-SA
🎬 Find a MovieWikipedia + WikidataCC BY-SA · CC0
🌸 Find an Anime · 📖 Find a MangaKitsuKitsu API terms
📕 Find a BookOpen LibraryOpen data
🔤 Define a WordWiktionary (English)CC BY-SA
💱 Convert CurrencyEuropean Central Bank rates, via FrankfurterPublic
📅 On This DayWikipedia's “On this day” feedCC BY-SA
🐾 PokédexPokéAPIFair use
📌Giving credit
Most of these ask to be credited when you show their data. Each piece's spark has a link back ({{show.url}}, {{anime.url}}…), and the weather has {{weather.credit}} — an Embed footer is a tidy place for it.

🤝Sharing nicely

Every bot on Kitcord asks the same sources, so look-ups are shared fairly.

  • Answers are remembered.Ask for Tokyo's weather twice and the second answer is instant — weather keeps until MET Norway's next update (about half an hour), shows for a few hours, most other things for a day.
  • Each bot can ask for 20 new things a minute.Repeats don't count. Past that, look-ups take Error ✗ for a moment — plenty for people typing commands, not for a timer looping through a hundred cities.
  • We never go over a source's own limit. When one is busy, look-ups wait a few seconds, then take Error ✗ rather than queue forever.
  • Each look-up costs 2 ⚡ — remembered answers too.
✨Exported bots
The Mini Engine in an export runs the same pieces from your own machine — places for the weather are built in, nothing else to install.

📝Good to know

  • Find an Anime and Find a Manga never return adult titles, even when they match best.
  • Convert Currency covers the ~30 currencies the European Central Bank publishes, updated once per working day.
  • On This Day reads the date in UTC; leave the day empty for today, or write 12-25 or Dec 25.
  • Define a Word is English only. Look Up on Wikipedia can search 29 languages.
  • Pair look-ups with a timer for a morning weather report or a history-of-the-day channel.

❓FAQ

Do Almanac look-ups need API keys?+

No. Wikipedia, MET Norway, TVmaze, Kitsu, Open Library, Wiktionary, Frankfurter, and PokéAPI are called by the Engine with shared cache and rate limits. You never paste a key.

What are found / missing / error?+

Every Almanac Piece has three exits. Found has the answer in the spark you named. Missing means nothing matched. Error means the source was busy or down — also logged in Activity.

How fast can a bot look things up?+

20 new queries per bot per minute. Cached repeats do not count. Each look-up costs 2 ⚡, remembered answers included.

Prefer a walkthrough of the product itself? Start on the no-code Discord bot builder — unbox The Almanac, then drop Check the Weather on a /weather Spell.