mx-xuangu

Translate natural-language stock queries into stock-screen API requests.

Updated Apr 10, 2026

Search Tags:#api #finance #csv #screening #stock #natural-language

Ready to run

npx skills add https://github.com/cattomgithub/eastmoney-mx-skills --skill mx-xuangu

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mx-xuangu
Source: https://github.com/cattomgithub/eastmoney-mx-skills/tree/main/mx-xuangu
Command: npx skills add https://github.com/cattomgithub/eastmoney-mx-skills --skill mx-xuangu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve?

This Skill translates natural-language stock-picking queries into official stock-screen API requests, enabling users to quickly identify stocks that meet complex criteria without needing to manually craft API calls.

Core Features & Use Cases

Parses user queries for stocks, sectors, indices and constituents across markets.
Calls the official stock-screen API and returns matching results plus basic statistics.
Outputs CSV, description, and raw API data for downstream analysis and auditing.

Quick Start

Run python mx_xuangu.py "your stock criteria" after exporting MX_APIKEY.

Frequently Asked Questions about mx-xuangu

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I screen stocks using natural language queries instead of manual API calls?▼

Stock screening with natural language translates text queries into official API requests. It parses criteria for stocks, sectors, and indices across markets, returning matching results and statistics without manual API calls.

What data formats can I export from a natural-language stock screening API response?▼

Natural-language stock screening outputs CSV, description, and raw API data. These formats support downstream analysis and auditing, parsing either full dataList responses or partialResults from the official stock-screen API.

Do I need an API key to run natural-language stock screening queries?▼

Yes, natural-language stock screening requires MX_APIKEY for authenticating official stock-screen API requests. You must export MX_APIKEY before executing your natural-language stock-picking queries.

Can I retrieve partial results when a stock screening API query is incomplete?▼

Yes, natural-language stock screening can parse partialResults from the official API. This ensures you still retrieve matching stocks and statistics even when the API response is not a full dataList.

What types of financial entities can I query using natural-language stock screening?▼

Natural-language stock screening parses queries for stocks, sectors, indices, and constituents across various markets. It translates these natural-language criteria into official API requests to return matching financial instruments.