TWSE MCP Server

"""Prompt for market hotspot monitoring using TWSE OpenAPI endpoints."""

from fastmcp.prompts.prompt import PromptMessage, TextContent


def market_hotspot_monitoring_prompt(monitoring_scope: str = "comprehensive", date_filter: str = "today") -> PromptMessage:
    """Prompt for market hotspot monitoring using TWSE OpenAPI endpoints."""
    content = f"""Market Hotspot Monitoring for Taiwan Stock Market:

You are a Taiwan stock market monitoring expert. Use the following TWSE OpenAPI endpoints to identify market hotspots, trending stocks, and important market developments:

### Available APIs for Hotspot Detection:

**News & Announcements:**
- `get_company_major_news(code)`: Company major announcements (filter by company or get all)
- `get_twse_news(start_date, end_date)`: Latest TWSE official news and announcements (with optional date filtering)
- `get_twse_events(top=10)`: TWSE events and activities

**Market Activity Indicators:**
- `get_real_time_trading_stats()`: Real-time market statistics
- `get_market_index_info(category, count, format)`: Market indices analysis with flexible filtering
  - Use `category="major", format="summary"` for quick market overview
  - Use `category="sector", format="simple"` to identify hot sectors
  - Use `category="thematic", count=10` for trending themes (AI, 5G, ESG, etc.)
- `get_stock_daily_trading(code)`: Daily trading volume and price movements
- `get_etf_regular_investment_ranking()`: Popular ETF investment trends
- `get_top_foreign_holdings()`: Foreign investment flow indicators

**Corporate Actions:**
- `get_dividend_rights_schedule(code)`: Upcoming ex-dividend dates
- `get_warrant_daily_trading(code)`: Warrant trading activity (speculation indicator)

### Monitoring Scopes:

**1. Breaking News Monitoring (monitoring_scope="news"):**
Focus on `get_company_major_news()` and `get_twse_news(start_date, end_date)` to identify:
- Companies with significant announcements today
- Regulatory changes or policy updates
- Market-moving news and corporate actions
- Industry-specific developments

**2. Trading Activity Hotspots (monitoring_scope="trading"):**
Use trading-related APIs to find:
- Stocks with unusual volume or price movements
- ETFs gaining popularity in regular investment plans
- Warrant activity indicating market speculation
- Foreign investment flow changes

**3. Comprehensive Market Scan (monitoring_scope="comprehensive"):**
Combine all APIs for complete market overview:
- Major news affecting multiple sectors
- Trading volume and foreign investment patterns
- Upcoming corporate actions and their potential impact
- Overall market sentiment indicators

### Analysis Framework:

**Step 1: News Impact Assessment**
- Scan major announcements for market-moving potential
- Identify companies with multiple recent announcements
- Assess regulatory or policy impact on sectors

**Step 2: Trading Pattern Analysis**
- Compare current trading volumes with historical averages
- Identify foreign investment flow changes
- Monitor ETF and warrant activity for sentiment

**Step 3: Forward-Looking Indicators**
- Upcoming ex-dividend dates affecting stock prices
- Corporate events that may drive future trading
- TWSE events that may impact market structure

### Output Format:

**Market Hotspots Summary:**
🔥 **Top Hotspots Today:**
1. **Company/Sector**: Reason for attention, relevant news, trading impact
2. **Market Theme**: Description, affected stocks, trend analysis

📈 **Trading Activity Alerts:**
- High volume stocks with supporting news
- Foreign investment flow changes
- Popular investment trends (ETF rankings)

📅 **Upcoming Events:**
- Ex-dividend dates in next 5 trading days
- Important TWSE announcements or events
- Corporate actions to watch

🎯 **Investment Implications:**
- Short-term trading opportunities
- Medium-term trend shifts
- Risk factors to monitor

### Current Monitoring Request:
Monitoring Scope: {monitoring_scope}
Date Filter: {date_filter}

Please provide comprehensive market hotspot analysis using the appropriate APIs above.
"""
    return PromptMessage(role="user", content=TextContent(type="text", text=content))