{
  "markdown": "# 🪙 GoldStrike: Relentless Gold Price Monitor\n\n![Kotlin](https://img.shields.io/badge/kotlin-%237F52FF.svg?style=for-the-badge&logo=kotlin&logoColor=white)\n![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white)\n![Ktor](https://img.shields.io/badge/ktor-%23087CFA.svg?style=for-the-badge&logo=ktor&logoColor=white)\n![Gemini Extension](https://img.shields.io/badge/Gemini_Extension-gold--strike-blue?logo=google-gemini&logoColor=white)\n\nStop staring at charts like a peasant. Let the machines do the heavy lifting.\n\n**GoldStrike** is a high-performance, asynchronous Kotlin bot that relentlessly tracks the price of Gold (XAU) and strikes your Telegram DMs the exact second your target price is breached. Now also available as a **Gemini CLI Extension**!\n\n## 🔥 Why It's Badass\n- **Relentless Monitoring:** Powered by **Kotlin 2.3.0** Coroutines to track prices asynchronously without blocking the main thread.\n- **Modern Networking:** Engineered with **Ktor 3.1.0** CIO client, precise HTTP timeouts, and graceful JVM shutdowns.\n- **Zero-Bullshit Alerts:** Only alerts you when the price crosses your aggressively defined thresholds. No spam, no false alarms.\n- **Gemini CLI Extension:** Install it directly into your Gemini CLI for instant gold price queries during your workflow.\n- **MCP Integration:** Acts as a **Model Context Protocol (MCP)** server, allowing AI agents to query real-time gold prices directly.\n- **Battle-Tested:** High-precision unit testing using **MockK** ensuring every strike is calculated and verified.\n\n## 🚀 Instant Deployment (Gemini CLI)\n\nThe easiest way to use GoldStrike is as a [Gemini CLI extension](https://geminicli.com/extensions/).\n\n```bash\n# 1. Install the extension\ngemini extensions install https://github.com/goldyonwar/gold-price-notifier\n\n# 2. Ask Gemini for the gold price\ngemini \"What is the current gold price?\"\n```\n*Requires Java 17+ installed locally.*\n\n## ⚙️ Configuration (The Arsenal)\n\nIf you are running the **Telegram Watcher Bot**, you need to arm it with environment variables. Create a `.env` file in the root directory:\n\n**Intel Gathering (Pre-requisites):**\n- **Bot Token:** Talk to [@BotFather](https://t.me/BotFather) on Telegram to create your bot and get the token.\n- **Chat ID:** Forward a message from your target chat to [@userinfobot](https://t.me/userinfobot) or use `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates` to find your precise Chat ID.\n\n```env\n# Your Telegram Bot Token from @BotFather\nTELEGRAM_BOT_TOKEN=your_bot_token_here\n\n# Your personal Telegram Chat ID\nTELEGRAM_CHAT_ID=your_chat_id_here\n\n# The Strike Zones (Alert Triggers)\nTARGET_HIGH_PRICE=5100.0\nTARGET_LOW_PRICE=5080.0\n\n# Polling frequency in milliseconds (e.g., 60000 = 1 minute)\nCHECK_INTERVAL=60000\n```\n\n## 🛠 Mode 1: The Watcher Bot (Standard)\nThis is the default mode that monitors prices and sends Telegram alerts.\n\n### Option A: Docker (Recommended)\n```bash\n# 1. Build the image\ndocker build -t gold-watcher-bot .\n\n# 2. Run the container\ndocker run -d --name my_gold_bot --env-file .env gold-watcher-bot\n```\n\n### Option B: Gradle\n```bash\n./gradlew run\n```\n\n---\n\n## 🛠 Mode 2: MCP Server (AI Agent Integration)\nRun GoldStrike as a standalone MCP server to expose gold price tracking to your AI tools (Claude, etc.).\n\n```bash\n# Run with the --mcp flag\n./gradlew run --args=\"--mcp\"\n```\n\n### Building the Artifact\nTo use GoldStrike as a standalone JAR (required for some MCP clients), build the fat JAR first:\n\n```bash\n./gradlew shadowJar\n```\nThis produces the artifact at `build/libs/gold-price-notifier-all.jar`.\n\n**Exposed Tools:**\n- `get_gold_price`: Fetches the real-time gold price in USD (XAU).\n\n#### MCP Client Configuration (e.g., Claude Desktop)\n```json\n{\n  \"mcpServers\": {\n    \"gold-watcher\": {\n      \"command\": \"java\",\n      \"args\": [\n        \"-jar\",\n        \"/absolute/path/to/gold-price-notifier-all.jar\",\n        \"--mcp\"\n      ]\n    }\n  }\n}\n```\n\n## 🧪 Testing (Verifying the Strike)\nRun the automated test suite to ensure the tracker and MCP logic are working as expected:\n\n```bash\n./gradlew test\n```\n\n## 🛡️ License\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 4233,
  "sha": "9a47e6f36695d5ee52e3c281a5ad52c5edf20efce36a78b515a248dc1bfce2dd",
  "repo_slug": "goldyonwar/gold-price-notifier",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_goldyonwar_gold_price_notifier_24a4875a/readme"
}