# Juhe Data / 聚合数据 MCP

> Juhe Data provides a unified API layer for essential data services across China, letting your AI client access real-time intelligence in one go. You can check current weather and 3-day forecasts, audit ID card numbers for basic details, locate IPs to determine user regions, or pull the latest news headlines on any topic. It also handles things like currency exchange rates and lunar calendar data, turning scattered research into a single conversation.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** api-aggregator, weather-data, identity-verification, ip-lookup, data-services, developer-api

## Description

Juhe Data lets your AI agent gather essential background intelligence that used to require logging into five different websites. Instead of manually checking separate weather APIs for Beijing, then cross-referencing ID databases, you ask your client, and it handles the complexity. Your agent can instantly check real-time conditions, verify details from an ID card number, or look up where a specific IP address comes from—all through natural language conversation. This capability is invaluable when building background checks or monitoring local events without needing custom coding for every single data source. When you connect this MCP via Vinkius, your agent acts as a comprehensive intelligence layer, pulling accurate and reliable information on demand.

## Tools

### get_calendar_day
Retrieves specific holiday and calendar information for a single day.

### get_calendar_month
Provides general holiday schedules and calendar data for an entire month.

### get_constellation_horoscope
Fetches the daily horoscope based on Chinese constellation data.

### get_driving_test_questions
Generates a set of random questions for practice driving tests.

### get_exchange_rate
Returns the current exchange rate between two specified currencies.

### get_id_card_info
Extracts basic personal information from a provided Chinese ID card number.

### get_ip_lookup
Identifies the geographic location and network provider associated with an IP address.

### get_latest_news
Retrieves a collection of recent news headlines from various sources.

### get_oil_price
Provides the most recently reported oil prices within China.

### get_weather
Gets detailed weather information, including forecasts, for a specified city.

## Prompt Examples

**Prompt:** 
```
What's the weather in Beijing today?
```

**Response:** 
```
In Beijing, it's currently Sunny at 22°C with 35% humidity. The wind is blowing from the North at level 2. The forecast for the next 3 days remains clear with temperatures ranging between 12°C and 25°C.
```

**Prompt:** 
```
Check the information for ID card 110101199001011234.
```

**Response:** 
```
The ID card information shows the holder is a Male, born on January 1, 1990. The registration area is Dongcheng District, Beijing.
```

**Prompt:** 
```
Show me the latest tech news from Juhe.
```

**Response:** 
```
I've retrieved the latest tech news. Headlines include 'New Advances in AI Chips' and 'The Growth of China's Digital Economy'. Would you like the links to the full articles?
```

## Capabilities

### Check real-time weather and forecasts
Your client pulls current weather conditions and the next three days of forecast for any city in China.

### Verify ID card details
The MCP validates Chinese ID numbers to retrieve basic holder information, including sex, birth date, and registration area.

### Determine IP address location
It looks up an IP address to identify the user's geographical region and network provider.

### Gather current news headlines
Your agent fetches the latest articles and headlines across multiple categories for background research.

### Retrieve financial and calendar data
You can get up-to-date currency exchange rates, oil prices, or specific holiday information for a given month.

## Use Cases

### Assessing a potential partner's background.
A compliance officer needs to vet an international vendor. They ask their agent to run the `get_id_card_info` tool against provided IDs, and then use `get_latest_news` to check if the company has any recent negative press coverage. The agent consolidates both data points into one report.

### Planning a complex logistics trip.
A manager needs to route a team through three different Chinese cities. They prompt their client: 'What's the weather in City A, and what are the local holidays in City C?' The agent calls `get_weather` for both locations and `get_calendar_month`, giving them clear go/no-go criteria.

### Building a market intelligence dashboard.
A financial analyst needs to track global movements. They ask the agent to pull the current oil price using `get_oil_price` and compare it to the latest currency exchange rate from `get_exchange_rate`, immediately giving them a comprehensive view of economic factors.

### Understanding user origin for debugging.
A developer is tracking an error report. They provide the IP address, and the agent uses `get_ip_lookup` to pinpoint the region. This allows them to immediately narrow down the problem scope without needing manual GeoIP services.

## Benefits

- Eliminate multi-site lookups. Instead of checking multiple external APIs for different pieces of info (like weather, ID verification, and news), your agent calls one tool to get everything it needs.
- Improve compliance workflow speed. Use the `get_id_card_info` tool to automate basic identity checks. Your client processes the data instantly, letting you focus on review instead of retrieval.
- Gain immediate geographical context. The `get_ip_lookup` tool tells you exactly where a user's IP address originates from, which is critical for fraud detection and regional analysis.
- Stay current without manual scraping. Use `get_latest_news` to pull diverse headlines across different categories, keeping your research fresh with just a prompt.
- Handle complex data types simply. Need to know the exchange rate or today's local holidays? The MCP handles `get_exchange_rate` and `get_calendar_month`, making multi-domain queries easy.

## How It Works

The bottom line is that instead of building complex code flows for data lookup, you just talk to your agent and it handles the integration layer itself.

1. Subscribe to this MCP and input your required Juhe AppKeys (e.g., Weather, ID, News) into the Vinkius environment.
2. Tell your AI client what data you need using plain English—for example, 'What is the weather in Shanghai?' or 'Check this ID card number.'
3. Your agent invokes the appropriate tool from the MCP and returns structured, accurate information directly to your conversation.

## Frequently Asked Questions

**How do I use Juhe Data / 聚合数据 for weather forecasting?**
You prompt your agent asking for the forecast, and it uses `get_weather` to pull current conditions plus a three-day outlook for any Chinese city.

**Can Juhe Data / 聚合数据 verify ID cards?**
Yes. By calling `get_id_card_info`, your agent verifies basic personal details like the holder's sex, birth date, and registration area using an ID number.

**What if I need to know a location from just an IP address? Use Juhe Data / 聚合数据.**
The `get_ip_lookup` tool handles this. You provide the IP, and your agent returns the associated geographic region and network provider.

**Is Juhe Data / 聚合数据 good for finance data?**
It is. Use tools like `get_exchange_rate` to get current currency rates or `get_oil_price` for the latest oil market figures.

**Does Juhe Data / 聚合数据 cover historical news?**
No, it focuses on real-time data. Use `get_latest_news` to pull current headlines; it doesn't search an archive of articles.