Mapulse 🇰🇷
Korean stock market AI analyst Telegram bot. Free, no billing — just set your bot token and go 한국 주식, 시장 분위기, 해외 변수까지 분석해주는 AI .
Quick Start
CODEBLOCK0
All configuration is via environment variables. No .env files are loaded automatically.
Environment Variables
| Variable | Required | Description |
|---|
| INLINECODE1 | ✅ | Telegram bot token from @BotFather |
| INLINECODE2 |
❌ | 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 |
|---|
| INLINECODE17 | Evening briefing with watchlist | INLINECODE18 (UTC) |
| INLINECODE19 |
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
CHATIDS |
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.
Mapulse 🇰🇷
韩国股市AI分析Telegram机器人。免费，无需付费——只需设置你的机器人令牌即可运行。分析韩国股票、市场情绪及海外变量。
快速开始
bash
1. 安装依赖
pip install python-telegram-bot pykrx requests beautifulsoup4
2. 设置你的机器人令牌
export TELEGRAM
BOTTOKEN=你的令牌
3. 启动机器人
cd bot && python3 mapulse_bot.py
所有配置均通过环境变量完成。不会自动加载.env文件。
环境变量
| 变量 | 必需 | 描述 |
|---|
| TELEGRAMBOTTOKEN | ✅ | 来自@BotFather的Telegram机器人令牌 |
| OPENROUTERAPIKEY |
❌ | AI深度分析（OpenRouter） |
| ANTHROPIC
APIKEY | ❌ | AI深度分析（Anthropic，备选） |
| DART
APIKEY | ❌ | 韩国企业披露数据 |
| ALLOWED_GROUPS | ❌ | 限制特定Telegram群组ID |
| MAPULSE_DB | ❌ | SQLite路径（默认：data/mapulse.db） |
| MAPULSE
CLAUDEMODEL | ❌ | LLM模型覆盖（默认：claude-sonnet-4） |
| KOREA
STOCKWATCHLIST | ❌ | 默认股票代码，逗号分隔 |
| RATE
LIMITPER_MIN | ❌ | 每用户每分钟最大请求数（默认：10） |
| RATE
LIMITCOOLDOWN | ❌ | 请求间最小间隔秒数（默认：3） |
| OPS
CHATIDS | ❌ | 你的Telegram用户ID，用于每日统计 |
| MAPULSE
CHANNELID | ❌ | 用于公开推送的Telegram频道ID |
| OPENNEWS_TOKEN | ❌ | 6551.io新闻API令牌 |
| TWITTER_TOKEN | ❌ | 6551.io Twitter API令牌 |
用户可执行操作
在Telegram中自然输入（韩语/中文/英语）：
- - 股票查询： 삼성전자, NAVER, 005930
- 原因分析： 삼성 왜 빠졌어?
- 比较： 비교 삼성 하이닉스
- 市场： 시황, 코스피, sector, 업종
- 外汇/加密货币/大宗商品： 환율, 비트코인, 금, 원유
- DART披露： 삼성 공시
- 提醒： /alert 005930 3.0
Mapulse是专门针对韩国股票市场的分析AI。
只需输入股票名称或问题，即可快速整理出股票分析、市场摘要、投资者情绪及海外变量解读。
其特点并非简单罗列新闻，
而是以判断为核心，整理出
当前应关注什么以及需要检查哪些风险。
定时脚本（可选）
该技能包含定时脚本，可向机器人自己的用户（与机器人互动过的人）发送定时简报。这些脚本仅在明确设置定时任务后运行：
| 脚本 | 用途 | 建议时间 |
|---|
| cronbriefing.py | 晚间简报（含关注列表） | 0 13 1-5（UTC） |
| cronplatform_push.py morning |
盘前简报 | 30 7
1-5（CST） |
| cron
platformpush.py midday | 午间回顾 | 20 11
1-5（CST） |
| cron
platformpush.py evening | 隔夜简报 | 50 19
1-5（CST） |
| cron
newsscan.py | 突发新闻提醒 |
/30 0-6 * 1-5（UTC） |
| cron
dailymetrics.py | 向OPS
CHATIDS发送使用统计 | 0 8
*（CST） |
| cron
newsaggregate.py | 新闻摘要 | 每日3次 |
以上均不会自动运行。 你需要手动将其添加到crontab中。
数据来源（免费，无需密钥）
- - pykrx — KRX官方KOSPI/KOSDAQ数据
- 雅虎财经 — 实时报价、外汇、大宗商品
- Daum金融 — 行业排名、热门股票
- CoinGecko — 加密货币价格
持久化存储
机器人存储本地SQLite数据库（默认：data/mapulse.db），包含：
- - 用户记录（Telegram用户ID、用户名、调用次数）
- 关注列表和提醒
- 推送日志和已读新闻哈希
- 用户资料（关注股票、推送偏好）
不存储任何支付数据、账单信息或外部凭证。
