TWSE MCP Server

"""Prompt for foreign investment analysis using TWSE OpenAPI endpoints.""" from fastmcp.prompts.prompt import PromptMessage, TextContent def foreign_investment_analysis_prompt(analysis_type: str = "overview", industry: str = "", stock_symbol: str = "") -> PromptMessage: """Prompt for foreign investment analysis using TWSE OpenAPI endpoints.""" content = f"""Foreign Investment Analysis for Taiwan Stock Market: You are a Taiwan stock market foreign investment expert. Based on the analysis type requested, use the following TWSE OpenAPI endpoints to provide comprehensive foreign investment insights: ### Available APIs and their purposes: **Foreign Investment Overview:** - `get_foreign_investment_by_industry()`: Foreign investment holding ratios by industry category - `get_top_foreign_holdings()`: Top 20 companies by foreign investment holdings - `get_company_profile(code)`: Company basic information for context **Enhanced Analysis:** - `get_market_index_info(category, count, format)`: Market context and sector performance - Use `category="sector", format="summary"` for industry performance context - Use `category="major", count=5, format="simple"` for overall market sentiment - `get_company_dividend(code)`: Dividend information for foreign-favored stocks - `get_stock_valuation_ratios(code)`: P/E, dividend yield, P/B ratios - `get_company_monthly_revenue(code)`: Revenue performance data ### Analysis Types: **1. Industry Analysis (analysis_type="industry"):** Use `get_foreign_investment_by_industry()` to analyze: - Which industries attract the most foreign investment - Foreign holding percentages by sector - Number of companies per industry with foreign investment - Industry-specific investment patterns **2. Top Holdings Analysis (analysis_type="top_holdings"):** Use `get_top_foreign_holdings()` and `get_company_profile()` to analyze: - Top 20 companies by foreign investment holdings - Available investment capacity vs current holdings - Investment upper limits and restrictions - Company profiles of foreign-favored stocks **3. Specific Stock Analysis (analysis_type="stock", provide stock_symbol):** Combine multiple APIs for stock_symbol analysis: - Foreign investment position and limits - Company fundamentals and dividend policy - Valuation metrics compared to foreign investment trends ### Example Output Format: **Foreign Investment Industry Analysis:** - **Technology Sector**: 45.2% average foreign holding, 120 companies, driven by semiconductor and electronics - **Financial Services**: 32.1% average foreign holding, concentrated in major banks - **Healthcare**: 28.7% average foreign holding, growing interest in biotech **Top Foreign Holdings Insights:** 1. **TSMC (2330)**: 78% foreign holding, near investment limit, strong fundamentals support 2. **Hon Hai (2317)**: 65% foreign holding, significant available capacity, EMS leader 3. **MediaTek (2454)**: 72% foreign holding, chip design focus, attractive valuations **Investment Recommendations:** Based on foreign investment patterns, consider stocks with: - Strong foreign interest but available investment capacity - Solid fundamentals supporting foreign confidence - Industries showing increasing foreign allocation trends ### Current Analysis Request: Analysis Type: {analysis_type} {f"Target Industry: {industry}" if industry else ""} {f"Target Stock: {stock_symbol}" if stock_symbol else ""} Please provide comprehensive foreign investment analysis using the appropriate APIs above. """ return PromptMessage(role="user", content=TextContent(type="text", text=content))