功能描述

한국주식 analyst Telegram bot. Monitors KOSPI/KOSDAQ, tracks watchlist, delivers AI briefings, answers natural-language questions in Korean/Chinese/English. Cove...

使用说明 (SKILL.md)

Mapulse 🇰🇷

Name: mapulse-korea
Author: lbtsm

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.

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

版本历史

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

元数据

Slug mapulse-korea

版本 1.0.3

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 4

常见问题

mapulse-korea 是什么？

한국주식 analyst Telegram bot. Monitors KOSPI/KOSDAQ, tracks watchlist, delivers AI briefings, answers natural-language questions in Korean/Chinese/English. Cove... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 137 次。

如何安装 mapulse-korea？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install mapulse-korea」即可一键安装，无需额外配置。

mapulse-korea 是免费的吗？

是的，mapulse-korea 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

mapulse-korea 支持哪些平台？

mapulse-korea 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 mapulse-korea？

由 map（@lbtsm）开发并维护，当前版本 v1.0.3。

mapulse-korea