jquants-mcp

What This Skill Does

The jquants-mcp skill provides an interface to the Japan Exchange Group's (JPX) official J-Quants API, allowing OpenClaw agents to query real-time and historical stock market data for companies listed on the Tokyo Stock Exchange (TSE). This tool bridges the gap between complex financial data and AI agents, enabling users to programmatically fetch OHLCV (Open, High, Low, Close, Volume) pricing, detailed financial statements including revenue, net profit, EPS, and ROE, as well as upcoming earnings announcement schedules. By integrating this skill, your agent can perform sophisticated market analysis, track individual stock performance, and maintain an awareness of corporate reporting timelines without manual data retrieval.

Installation

To begin, ensure you have a registered account at the J-Quants official portal. Once registered, you must set the JQUANTS_MAIL_ADDRESS and JQUANTS_PASSWORD environment variables in your OpenClaw environment configuration. Install the tool using your preferred Python package manager via the terminal: pip install jquants-mcp. Finally, register the skill within OpenClaw using the command: clawhub install openclaw/skills/skills/ajtgjmdjp/jquants-mcp.

Use Cases

This skill is designed for quantitative analysts, retail investors, and developers building financial agents. Common use cases include:

1. Financial Research: Automatically pulling the latest quarterly financial results to evaluate company performance trends.
2. Price Monitoring: Tracking historical price volatility of specific assets for backtesting or strategy validation.
3. Earnings Intelligence: Aggregating upcoming earnings announcements for a watchlist to anticipate market volatility.
4. Comparative Analysis: Comparing KPIs like ROE or profit margins between direct industry competitors on the TSE.

Example Prompts

1. "Look up the stock code for Nintendo and then retrieve its daily price history for the month of October 2024."
2. "What are the latest financial summary metrics for Sony (6758)? Please show me the revenue and profit."
3. "Can you check if there are any companies in my watchlist with earnings announcements scheduled for the next two weeks?"

Tips & Limitations

This tool is strictly for personal use as mandated by the J-Quants Terms of Service. Data redistribution, sharing, or commercial use of the API results is strictly prohibited. The API provides high-quality official data, but users should be mindful of rate limits imposed by the J-Quants platform. If you encounter connectivity errors, use the jquants-mcp test command to verify your credentials. Note that while the tool supports searches using Japanese company names, using specific stock codes is generally more reliable for consistent results.