japanfinance-agent

What This Skill Does

The japanfinance-agent is a sophisticated compound MCP (Model Context Protocol) agent designed to unify the fragmented landscape of Japanese financial data. Instead of forcing you to navigate multiple regulatory and government portals, this agent integrates six distinct, high-value data sources: EDINET for official securities filings, TDNET for timely corporate disclosures, e-Stat for government-backed macroeconomic statistics, BOJ for central bank policy and monetary data, real-time financial news, and J-Quants for historical stock price data. By abstracting these connections, the agent provides a holistic, structured view of both individual corporate health and the broader Japanese macroeconomic environment.

Installation

To get started with the agent, use the ClawKit CLI or pip. It is highly recommended to install the 'all' dependency set to take full advantage of the compound analysis features:

clawhub install openclaw/skills/skills/ajtgjmdjp/japanfinance-agent

Alternatively, if you prefer a lighter footprint, you can use pip directly: pip install "japanfinance-agent[all]"

If you only need specific sources, you can install subsets like pip install "japanfinance-agent[edinet,news]". The agent is designed to be resilient; if a specific source is not installed or configured, the agent will gracefully inform you rather than crashing.

Use Cases

• Comprehensive Company Analysis: Fetch a complete profile including XBRL financial statements from EDINET, recent disclosures from TDNET, news sentiment, and technical price data from J-Quants.
• Macroeconomic Monitoring: Generate snapshots of the Japanese economy by pulling real-time GDP, CPI, and unemployment figures from e-Stat alongside current interest rate data from the Bank of Japan.
• Earnings Season Tracking: Maintain a watchlist of ticker symbols and automatically query the agent to see if any recent earnings releases or dividend announcements have been filed via TDNET.
• Regulatory Filing Review: Access raw EDINET filings for deep-dive research into company governance or business risks.

Example Prompts

1. "Analyze Toyota Motor Corporation (7203) by pulling their latest EDINET filings and recent stock price trends from J-Quants."
2. "Give me a macroeconomic snapshot of Japan today, focusing on the latest CPI data and BOJ interest rate policy."
3. "Check for any new earnings disclosures for a watchlist consisting of Sony (6758) and Keyence (6861)."

Tips & Limitations

• Configuration: Ensure your API keys for EDINET and your credentials for J-Quants are saved in your environment variables. Without these, the agent will report missing data for specific sources.
• Graceful Degradation: If you don't have an e-Stat App ID, the agent will still work for news and TDNET, but you will not receive macro statistics. Add sources incrementally as needed.
• Data Latency: While news and TDNET are near real-time, keep in mind that official government filings and BOJ data may be subject to standard reporting delays inherent to the source providers.