← Back to Skills Marketplace
837
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install jquants-mcp
Description
Access JPX stock market data via J-Quants API — search stocks, get daily OHLCV prices, financial summaries (revenue, profit, EPS, ROE), and earnings calendar...
README (SKILL.md)
J-Quants: JPX Stock Market Data
Access Tokyo Stock Exchange (TSE) listed stock data via the official J-Quants API. Search stocks, get daily OHLCV prices, financial summaries, and earnings announcement calendar.
Important: This tool is for personal use only. Data redistribution is prohibited by J-Quants Terms of Service. https://jpx-jquants.com/termsofservice
Use Cases
- Search for TSE-listed stocks by code or company name
- Get daily OHLCV price data for any stock
- Retrieve financial summaries (revenue, profit, EPS, ROE)
- Check upcoming earnings announcement dates
- Compare financial metrics across companies
Commands
Search stocks
# By stock code
jquants-mcp search 7203
# By company name (Japanese)
jquants-mcp search トヨタ
# JSON output
jquants-mcp search ソニー --json-output
Get stock prices
# Default: last 30 days
jquants-mcp price 7203
# With date range
jquants-mcp price 7203 --start-date 2024-01-01 --end-date 2024-12-31
# JSON output
jquants-mcp price 7203 --json-output
Get financial data
jquants-mcp financials 7203
jquants-mcp financials 6758 --json-output
Get earnings calendar
# Default: next 30 days
jquants-mcp calendar
# With date range
jquants-mcp calendar --start-date 2024-04-01 --end-date 2024-06-30
Test connectivity
jquants-mcp test
Workflow
jquants-mcp search \x3Ccompany>→ find stock codejquants-mcp price \x3Ccode>→ get price historyjquants-mcp financials \x3Ccode>→ get financial datajquants-mcp calendar→ check earnings dates
Setup
- Requires
JQUANTS_MAIL_ADDRESSandJQUANTS_PASSWORDenvironment variables - Free account registration: https://jpx-jquants.com/
- Python package:
pip install jquants-mcporuv tool install jquants-mcp
Terms of Service
By using this tool, you agree to the J-Quants Terms of Service. Data is for personal use only — redistribution is prohibited.
Usage Guidance
This skill appears coherent with its purpose, but take routine precautions before installing and running it: 1) Verify the jquants-mcp package on the source registry (PyPI or the 'uv' registry) and check the maintainer and code/release page if available. 2) Prefer using a dedicated J-Quants account or an API token if the service offers one rather than reusing your primary email/password. 3) Understand J-Quants Terms of Service — redistribution is prohibited. 4) Because the install creates a binary, inspect the package contents or source repository when possible and avoid installing from unknown/untrusted URLs. 5) If you have concerns, run the CLI in an isolated environment (container or VM) and monitor network calls during first use.
Capability Analysis
Type: OpenClaw Skill
Name: jquants-mcp
Version: 0.1.2
The OpenClaw AgentSkills bundle for 'jquants-mcp' appears benign. It provides access to the J-Quants API for stock market data. The `SKILL.md` file clearly outlines the skill's purpose, commands, and setup, including the requirement for `JQUANTS_MAIL_ADDRESS` and `JQUANTS_PASSWORD` environment variables, which is a standard practice for API authentication and not indicative of credential theft. The installation instructions use `uv` to install the `jquants-mcp` Python package, and all command examples invoke the `jquants-mcp` binary with expected arguments. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent.
Capability Assessment
Purpose & Capability
Name/description, required binary (jquants-mcp), and required env vars (JQUANTS_MAIL_ADDRESS, JQUANTS_PASSWORD) all align with a CLI that authenticates to J-Quants and fetches market/financial data. The setup notes even mention pip install jquants-mcp, which is consistent.
Instruction Scope
SKILL.md only instructs running the jquants-mcp CLI with specific commands (search, price, financials, calendar, test). It references only the declared environment variables and the official J-Quants site/ToS. There are no instructions to read unrelated files, exfiltrate data, or contact third-party endpoints outside the stated API.
Install Mechanism
Install spec uses an 'uv' package installation that creates the jquants-mcp binary; SKILL.md also mentions 'pip install jquants-mcp'. This is proportionate to a CLI-based skill, but the trustworthiness depends on the package registry/source (uv registry or PyPI). Because the skill will install a binary package, users should verify the package origin before installing.
Credentials
Only two env vars are required: JQUANTS_MAIL_ADDRESS and JQUANTS_PASSWORD. Those are appropriate for authenticating a user account on J-Quants. There are no unrelated secrets, cloud credentials, or excessive environment access requested.
Persistence & Privilege
always is false, there are no required config paths, and the skill does not request to modify other skills or system-wide settings. Autonomous invocation is allowed (platform default) but is not combined with unusual privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jquants-mcp - After installation, invoke the skill by name or use
/jquants-mcp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.2
Add int→str coercion, non-retryable status handling
v0.1.1
Add retry logic, async context manager, date validation
v0.1.0
- Initial release of jquants-mcp (v0.1.0)
- Access JPX (Tokyo Stock Exchange) stock data via the official J-Quants API
- Search for TSE-listed stocks by code or name, retrieve daily OHLCV prices, financial summaries, and earnings announcement calendar
- Multiple commands for searching, price retrieval, financial metrics, and earnings calendar
- Requires JQUANTS_MAIL_ADDRESS and JQUANTS_PASSWORD environment variables for authentication
- Usage limited to personal use per J-Quants Terms of Service
Metadata
Frequently Asked Questions
What is Jquants Mcp?
Access JPX stock market data via J-Quants API — search stocks, get daily OHLCV prices, financial summaries (revenue, profit, EPS, ROE), and earnings calendar... It is an AI Agent Skill for Claude Code / OpenClaw, with 837 downloads so far.
How do I install Jquants Mcp?
Run "/install jquants-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Jquants Mcp free?
Yes, Jquants Mcp is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Jquants Mcp support?
Jquants Mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Jquants Mcp?
It is built and maintained by ajtgjmdjp (@ajtgjmdjp); the current version is v0.1.2.
More Skills