← Back to Skills Marketplace
137
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install mapulse-korea
Description
한국주식 analyst Telegram bot. Monitors KOSPI/KOSDAQ, tracks watchlist, delivers AI briefings, answers natural-language questions in Korean/Chinese/English. Cove...
README (SKILL.md)
Mapulse 🇰🇷
Korean stock market AI analyst Telegram bot. Free, no billing — just set your bot token and go 한국 주식, 시장 분위기, 해외 변수까지 분석해주는 AI .
Quick Start
# 1. Install dependencies
pip install python-telegram-bot pykrx requests beautifulsoup4
# 2. Set your bot token
export TELEGRAM_BOT_TOKEN=your_token_here
# 3. Start the bot
cd bot && python3 mapulse_bot.py
All configuration is via environment variables. No .env files are loaded automatically.
Environment Variables
| Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN |
✅ | Telegram bot token from @BotFather |
OPENROUTER_API_KEY |
❌ | AI deep analysis (OpenRouter) |
ANTHROPIC_API_KEY |
❌ | AI deep analysis (Anthropic, alternative) |
DART_API_KEY |
❌ | Korean corporate disclosure data |
ALLOWED_GROUPS |
❌ | Restrict to specific Telegram group IDs |
MAPULSE_DB |
❌ | SQLite path (default: data/mapulse.db) |
MAPULSE_CLAUDE_MODEL |
❌ | LLM model override (default: claude-sonnet-4) |
KOREA_STOCK_WATCHLIST |
❌ | Default tickers, comma-separated |
RATE_LIMIT_PER_MIN |
❌ | Max requests per user per minute (default: 10) |
RATE_LIMIT_COOLDOWN |
❌ | Min seconds between requests (default: 3) |
OPS_CHAT_IDS |
❌ | Your Telegram user ID for daily stats |
MAPULSE_CHANNEL_ID |
❌ | Telegram channel ID for public pushes |
OPENNEWS_TOKEN |
❌ | 6551.io news API token |
TWITTER_TOKEN |
❌ | 6551.io Twitter API token |
What Users Can Do
Type naturally in Telegram (Korean / Chinese / English):
- Stock query: 삼성전자, NAVER, 005930
- Why analysis: 삼성 왜 빠졌어?
- Compare: 비교 삼성 하이닉스
- Market: 시황, 코스피, sector, 업종
- FX/Crypto/Commodity: 환율, 비트코인, 금, 원유
- DART disclosures: 삼성 공시
- Alerts: /alert 005930 3.0
Mapulse는 한국 주식 시장에 특화된 분석 AI입니다. 종목명이나 질문만 입력하면 종목 분석, 시장 요약, 투자자 심리, 해외 변수 해석까지 빠르게 정리해드립니다.
단순히 뉴스를 나열하는 것이 아니라, 지금 무엇을 봐야 하는지와 어떤 리스크를 체크해야 하는지를 판단 중심으로 정리해주는 것이 특징입니다.
Cron Scripts (optional)
The skill includes cron scripts that send scheduled briefings to your bot's own users (people who have interacted with your bot). These only run if you explicitly schedule them:
| Script | Purpose | Suggested schedule |
|---|---|---|
cron_briefing.py |
Evening briefing with watchlist | 0 13 * * 1-5 (UTC) |
cron_platform_push.py morning |
Pre-market briefing | 30 7 * * 1-5 (CST) |
cron_platform_push.py midday |
Midday recap | 20 11 * * 1-5 (CST) |
cron_platform_push.py evening |
Overnight briefing | 50 19 * * 1-5 (CST) |
cron_news_scan.py |
Breaking news alerts | */30 0-6 * * 1-5 (UTC) |
cron_daily_metrics.py |
Usage stats to OPS_CHAT_IDS | 0 8 * * * (CST) |
cron_news_aggregate.py |
News digest | 3x daily |
None of these run automatically. You opt in by adding them to your crontab.
Data Sources (free, no keys needed)
- pykrx — KRX official KOSPI/KOSDAQ data
- Yahoo Finance — real-time quotes, FX, commodities
- Daum Finance — sector rankings, trending stocks
- CoinGecko — crypto prices
Persistence
The bot stores a local SQLite database (default: data/mapulse.db) containing:
- User records (Telegram user ID, username, call count)
- Watchlists and alerts
- Push logs and seen news hashes
- User profiles (focus stocks, push preferences)
No payment data, no billing, no external credentials are stored.
Usage Guidance
This package appears to be what it claims: a Telegram bot that scrapes market data, stores user records in a local SQLite DB, and optionally calls Anthropic/OpenRouter when you provide an API key. Before installing or running: 1) Review and control TELEGRAM_BOT_TOKEN (anyone with it can send messages as your bot); run the bot in an isolated environment (container/VM) if you don't trust the code. 2) If you schedule the cron scripts, understand they will iterate your DB users and push messages — only add them to crontab if intended. 3) Audit network endpoints if you need strict egress controls (the code fetches public market/news APIs and will call AI APIs if keys are set). 4) Be mindful that providing ANTHROPIC_API_KEY or OPENROUTER_API_KEY may send user queries (including short user messages and formatted market data) to external LLM services and could incur costs. 5) If you need stronger privacy, change MAPULSE_DB path to a controlled location and inspect/backup the DB before/after use.
Capability Analysis
Type: OpenClaw Skill
Name: mapulse-korea
Version: 1.0.3
The Mapulse skill is a comprehensive and well-architected Telegram bot designed for Korean stock market analysis. It integrates multiple legitimate data sources including Naver Finance, Daum Finance, Yahoo Finance, and the pykrx library to provide real-time quotes, sector rankings, and corporate disclosures. The code implements robust features such as rate limiting, intent classification, and a two-phase response system (fast data fetch followed by deep AI analysis via OpenRouter/Claude). No evidence of malicious behavior, data exfiltration, or unauthorized remote execution was found; the collection of Telegram user metadata (ID, username, and avatar) is consistent with the bot's functional requirements for managing user watchlists and personalized briefings.
Capability Assessment
Purpose & Capability
Name/description describe a Telegram bot that monitors Korean markets, provides AI analysis, and pushes briefings — the included Python code (bot entrypoint, scrapers, DB layer, AI wrapper, cron scripts) matches that purpose. Environment variables in SKILL.md (TELEGRAM_BOT_TOKEN, DART_API_KEY, ANTHROPIC/OPENROUTER keys, DB path, etc.) are relevant to the features described. No unrelated cloud credentials or surprising binaries are requested.
Instruction Scope
Runtime instructions are straightforward: install stated Python packages, set TELEGRAM_BOT_TOKEN (optional AI keys) and run bot. The code does access local SQLite (MAPULSE_DB) and will fetch external data (Daum, Yahoo, CoinGecko, 6551.io, Anthropic/OpenRouter) — this is expected for a market bot. The optional cron scripts will read the DB for users and POST messages to Telegram using TELEGRAM_BOT_TOKEN; note these will broadcast to users if you schedule them (SKILL.md states they do not run automatically). No instructions ask the agent to read unrelated system files or hidden credentials.
Install Mechanism
There is no automatic install spec in the registry (instruction-only). SKILL.md tells the user to pip install common Python packages (python-telegram-bot, pykrx, requests, beautifulsoup4). This is proportionate to the code; there are no downloads from unknown URLs or archive extraction operations in the manifest.
Credentials
All environment variables declared in SKILL.md map to the bot's behavior (Telegram token, AI API keys, DART API, DB path, rate limits, optional news/twitter tokens). No unrelated or excessive secrets are requested. The registry lists no required env vars (all are optional) which matches SKILL.md marking them optional.
Persistence & Privilege
The skill does persist local state in a SQLite DB (user records, watchlists, alerts, push logs, preferences) — that's expected for a messaging bot. always is false and the skill does not modify other skills or system-wide agent settings. Be aware cron scripts, if installed by you in crontab, will proactively send messages to users in the DB using your TELEGRAM_BOT_TOKEN.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mapulse-korea - After installation, invoke the skill by name or use
/mapulse-korea - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
No code or functionality changes in this release.
- Documentation was updated for clarity and completeness.
- No new features, fixes, or file modifications.
v1.0.2
- Minor update to the skill description for improved clarity and style.
- No user-facing feature or configuration changes.
v1.0.1
- Environment variable TELEGRAM_BOT_TOKEN is now optional; if not set, Telegram features are disabled.
- Added Korean language details and feature explanation to the documentation, emphasizing interpretation and risk assessment features.
- No changes to core functionality or code. Documentation update only.
v1.0.0
Initial release of the mapulse Telegram bot skill.
- AI-powered Korean stock market analyst supporting KOSPI/KOSDAQ, watchlists, and AI briefings
- Answers natural-language questions in Korean, Chinese, and English
- Supports queries for stock prices, sector rankings, DART disclosures, crash alerts, crypto, and market news
- Built-in cron scripts for scheduled briefings, market digests, and usage stats (manual setup required)
- Free and open, no billing or payment data stored; configuration via environment variables only
Metadata
Frequently Asked Questions
What is mapulse-korea?
한국주식 analyst Telegram bot. Monitors KOSPI/KOSDAQ, tracks watchlist, delivers AI briefings, answers natural-language questions in Korean/Chinese/English. Cove... It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.
How do I install mapulse-korea?
Run "/install mapulse-korea" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is mapulse-korea free?
Yes, mapulse-korea is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does mapulse-korea support?
mapulse-korea is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created mapulse-korea?
It is built and maintained by map (@lbtsm); the current version is v1.0.3.
More Skills