agents
A Telegram weather query bot based on the OpenAI Agents SDK
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: agents. It is used for: A Telegram weather query bot based on the OpenAI Agents SDK Full Skill content: https://321skill.com/skills/agents-agents-sdk-telegram/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the need for quickly querying real-time global weather information on Telegram. Unlike traditional methods that require opening a specific app or website, it allows users to obtain weather data through natural language conversation, offering greater convenience, especially on mobile devices.
Usage is straightforward: simply chat with the bot on Telegram and send a natural language instruction like "what's the weather in Ubud?". The bot will call the Open-Meteo API (no API key required) to fetch real-time temperature, weather conditions, and wind speed, and return the information in a user-friendly format.
It's particularly suitable for developers, travelers, or AI agent enthusiasts who frequently need to check the weather. Teams already using the OpenAI Agents SDK to build AI assistants can quickly integrate this weather query capability.
It is recommended to set it as the default tool in your Telegram Bot and pre-configure the TELEGRAM_BOT_TOKEN and OPENAI_API_KEY in the .env file. Note that it relies on the free Open-Meteo API, which may be subject to the service's availability, and it does not support historical weather data.
Key Features
Unlike most Telegram weather bots, it is built on the OpenAI Agents SDK and MCP protocol, enabling natural language understanding of any city name without requiring a fixed command format. Additionally, the Open-Meteo API is completely free and requires no registration.
Limitations
Requires Python 3.11+, an OpenAI API key, and a Telegram Bot Token. It relies on real-time data from the Open-Meteo API and does not support historical weather queries or forecasts.
FAQ
Do I need to apply for an Open-Meteo API key?
No, Open-Meteo is a completely free public API that does not require any key. You only need to provide your OpenAI API key and Telegram Bot Token.
Which cities are supported?
It supports any city worldwide, as long as the city name is recognized by the Open-Meteo API. Using English city names is recommended.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/agents-agents-sdk-telegram/raw/index.md to read the original Skill definition (Markdown format) for agents, and install it according to the instructions.
Raw Markdown URL for AI: /skills/agents-agents-sdk-telegram/raw/index.md