back
loading skill details...
一个为Fantasy NBA以色列联赛提供统计数据、排名和分析的MCP服务器。
---
name: Fantasy NBA 数据服务
description: 一个为Fantasy NBA以色列联赛提供统计数据、排名和分析的MCP服务器。
version: 1.0.0
---
# Fantasy NBA 数据服务
一个为Fantasy NBA以色列联赛提供统计数据、排名和分析的MCP服务器。
---
## ⚠️ 强制要求：API 密钥
**此 Skill 必须配置 API 密钥才能使用。**
- 首次使用时，如果 `.env` 中没有 `XBY_APIKEY`，**必须使用 AskUserQuestion 工具向用户询问 API 密钥**
- 拿到用户提供的密钥后，调用 `scripts.config.set_api_key(api_key)` 保存，然后继续处理
- 获取 API 密钥：https://xiaobenyang.com
- **禁止**在缺少 API 密钥时自行搜索或编造数据
---
## 工作流程（必须遵守）
你（大模型）是路由层，负责理解用户意图、选择工具、提取参数。代码只负责调用API。
```
用户输入 → 你选择工具 → 提取该工具需要的参数 → 调用 scripts.tools 中的函数 → 返回结果给用户
```
### 步骤
1. **检查 API 密钥**：如果 `scripts.config.settings.api_key` 为空，使用 AskUserQuestion 询问用户，拿到后调用 `scripts.config.set_api_key(key)` 保存
2. **选择工具**：根据用户意图从下方工具列表中选择对应的工具函数
3. **提取参数**：根据选中的工具，提取该工具需要的参数
4. **调用工具**：使用**关键字参数**调用 `scripts.tools` 中的函数，例如 `scripts.tools.search_schools(score='520', province='北京', category='综合')`
5. **返回结果**：将工具返回的 `raw` 数据整理后展示给用户
---
## 工具选择规则
根据用户意图选择对应的工具函数：
| 用户意图 | 工具函数 |
|---------|---------|
|
Get the average league rankings from the API.
IMPORTANT - SCORING SYSTEM EXPLANATION:
This is a ROTISSERIE (ROTO) fantasy league. Teams earn ranking points in 8 categories.
CRITICAL: Do NOT confuse "ranking points" with "rank position"!
- Category values (fg_percentage, ast, reb, etc.) = POINTS earned (higher is better)
- The "rank" field = actual position/place in standings (1 = first place)
HOW RANKING POINTS WORK:
- In each category, teams are ranked 1st to Nth (where N = number of teams)
- Best team in a category gets N points, second-best gets N-1, worst gets 1
- Example in 12-team league: 1st place = 12 pts, 2nd = 11 pts, ..., 12th = 1 pt
- total_points = sum of points from all 8 categories
- Overall "rank" is determined by total_points (highest total = rank 1)
EXAMPLE in a 12-team league:
{
"team": {"team_name": "Best Team"},
"ast": 12.0, // Earned 12 pts (1st place in assists)
"reb": 11.0, // Earned 11 pts (2nd place in rebounds)
"stl": 8.0, // Earned 8 pts (5th place in steals)
...other categories...
"total_points": 73.0, // Sum of all 8 category points
"rank": 1, // Overall standing: 1st place
"GP": 55 // Games played (informational only, not ranked)
}
Args:
order: Sort order for rankings.
- "desc" = best to worst (top teams first, "from top to bottom", "מלמעלה למטה")
- "asc" = worst to best (bottom teams first, "from bottom to top", "מלמטה למעלה")
Default is "desc".
Returns:
A list of teams with their rankings, total points, and stats per category.
Each item in the list is a dictionary with the following keys: {
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"fg_percentage": <ranking_points_for_field_goal_percentage>,
"ft_percentage": <ranking_points_for_free_throw_percentage>,
"three_pm": <ranking_points_for_three_pointers_made>,
"ast": <ranking_points_for_assists>,
"reb": <ranking_points_for_rebounds>,
"stl": <ranking_points_for_steals>,
"blk": <ranking_points_for_blocks>,
"pts": <ranking_points_for_points>,
"total_points": <sum_of_all_category_ranking_points>,
"rank": <overall_position_1_is_first_place>,
"GP": <games_played_not_ranked>
}
NOTES:
- Higher values in categories = better performance (more ranking points earned)
- "rank" field is opposite: lower number = better (1 is first place)
- GP (games played) is informational only, not used in scoring
- When referring to steals in Hebrew, use חטיפות (not גניבות)
- If you refer to comparing teams, distinguish between rank and total points, so f.e someone can be 1st place 70 total points and another team can be 2nd place 69 total points.
- In that case, the difference is 2 points, not 1 place.
| `scripts.tools.getAveragesLeagueRankings` |
|
Get the list of all teams in the fantasy league.
Use this endpoint to discover team IDs for use with other endpoints like getTeamDetails().
Returns:
A list of teams with their team_id and team_name.
Each item in the list is a dictionary with the following keys: {
"team_id": <integer_team_identifier>,
"team_name": <string_team_name>
}
NOTES:
- Team IDs are required for getTeamDetails(team_id)
- Team names may contain emojis or special characters
- The list includes all active teams in the league
| `scripts.tools.getTeams` |
|
Get the average statistics (actual performance numbers) for all teams from the API.
IMPORTANT: This returns ACTUAL PERFORMANCE STATS, NOT ranking points!
- This is different from getAveragesLeagueRankings() which returns ranking points
- Use this endpoint to see actual per-game averages (e.g., 25.3 assists per game)
- Use getAveragesLeagueRankings() to see rotisserie ranking points (e.g., 12 points earned)
Args:
use_normalized: If True, returns normalized data (0-1 scale) for comparison.
If False, returns raw statistical values (e.g., 45.6% FG, 12.3 AST).
Default is False.
Returns:
A list of teams with their actual statistical averages per game.
Each item in the list is a dictionary with the following structure:
{
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"stats": {
"FG%": <field_goal_percentage_as_decimal>,
"FT%": <free_throw_percentage_as_decimal>,
"3PM": <three_pointers_made_per_game>,
"AST": <assists_per_game>,
"REB": <rebounds_per_game>,
"STL": <steals_per_game>,
"BLK": <blocks_per_game>,
"PTS": <points_per_game>,
"GP": <games_played>
}
}
NOTES:
- Percentages are decimals (0.456 = 45.6%)
- All counting stats (3PM, AST, REB, STL, BLK, PTS) are per-game averages
- When use_normalized=True, all values are scaled 0-1 for heatmap visualization
- GP (games played) is a total count, not an average
| `scripts.tools.getAverageStats` |
|
Get comprehensive details for a specific team from the API.
This endpoint combines multiple data types for a single team:
1. Raw statistical averages (actual performance numbers)
2. Ranking points (rotisserie scoring system)
3. Category ranks (position in each category, 1=best)
4. Player roster with individual stats
IMPORTANT - Understanding the Data Sections:
"raw_averages" = Actual statistical performance (e.g., 45.6% FG, 12.3 assists per game)
"ranking_stats" = Rotisserie points earned in each category (see explanation below)
"category_ranks" = Ordinal position in each category (1=1st place, 2=2nd place, etc.)
"shot_chart" = Raw totals for field goals and free throws (not averages)
RANKING STATS EXPLANATION (Same as getAveragesLeagueRankings):
This is a ROTISSERIE (ROTO) fantasy league. Teams earn ranking points in 8 categories.
CRITICAL: Do NOT confuse "ranking points" with "category ranks"!
- ranking_stats values (e.g., ast: 12.0) = POINTS earned (higher is better)
- category_ranks values (e.g., AST: 1) = position/place (lower is better, 1 = first)
HOW RANKING POINTS WORK:
- In each category, teams are ranked 1st to Nth (where N = number of teams)
- Best team in a category gets N points, second-best gets N-1, worst gets 1
- Example in 12-team league: 1st place = 12 pts, 2nd = 11 pts, ..., 12th = 1 pt
- total_points = sum of points from all 8 categories
- Overall "rank" is determined by total_points (highest total = rank 1)
Args:
team_id: The ID of the team to get details for. Use getTeams() to see all team IDs.
Returns:
A dictionary containing comprehensive team information: {
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"espn_url": <espn_team_page_url_string>,
"shot_chart": {
"team": {"team_id": <id>, "team_name": <name>},
"fgm": <total_field_goals_made>,
"fga": <total_field_goals_attempted>,
"fg_percentage": <calculated_field_goal_percentage_as_decimal>,
"ftm": <total_free_throws_made>,
"fta": <total_free_throws_attempted>,
"ft_percentage": <calculated_free_throw_percentage_as_decimal>,
"gp": <games_played>
},
"raw_averages": {
"fg_percentage": <average_field_goal_percentage_as_decimal>,
"ft_percentage": <average_free_throw_percentage_as_decimal>,
"three_pm": <average_three_pointers_made_per_game>,
"ast": <average_assists_per_game>,
"reb": <average_rebounds_per_game>,
"stl": <average_steals_per_game>,
"blk": <average_blocks_per_game>,
"pts": <average_points_per_game>,
"gp": <games_played>,
"team": {"team_id": <id>, "team_name": <name>}
},
"ranking_stats": {
"team": {"team_id": <id>, "team_name": <name>},
"fg_percentage": <ranking_points_earned_in_fg_percentage>,
"ft_percentage": <ranking_points_earned_in_ft_percentage>,
"three_pm": <ranking_points_earned_in_three_pointers>,
"ast": <ranking_points_earned_in_assists>,
"reb": <ranking_points_earned_in_rebounds>,
"stl": <ranking_points_earned_in_steals>,
"blk": <ranking_points_earned_in_blocks>,
"pts": <ranking_points_earned_in_points>,
"gp": <games_played_not_ranked>,
"total_points": <sum_of_all_8_category_ranking_points>,
"rank": <overall_standing_1_is_first_place>
},
"category_ranks": {
"FG%": <ranking_points_earned_in_fg_percentage>,
"FT%": <ranking_points_earned_in_ft_percentage>,
"3PM": <ranking_points_earned_in_three_pointers>,
"AST": <ranking_points_earned_in_assists>,
"REB": <ranking_points_earned_in_rebounds>,
"STL": <ranking_points_earned_in_steals>,
"BLK": <ranking_points_earned_in_blocks>,
"PTS": <ranking_points_earned_in_points>
},
"players": [
{
"player_name": <player_full_name_string>,
"pro_team": <nba_team_abbreviation_string>,
"positions": <list_of_eligible_positions>,
"stats": {
"pts": <average_points_per_game>,
"reb": <average_rebounds_per_game>,
"ast": <average_assists_per_game>,
"stl": <average_steals_per_game>,
"blk": <average_blocks_per_game>,
"fgm": <average_field_goals_made_per_game>,
"fga": <average_field_goals_attempted_per_game>,
"ftm": <average_free_throws_made_per_game>,
"fta": <average_free_throws_attempted_per_game>,
"fg_percentage": <field_goal_percentage_as_decimal>,
"ft_percentage": <free_throw_percentage_as_decimal>,
"three_pm": <average_three_pointers_made_per_game>,
"minutes": <average_minutes_per_game>,
"gp": <total_games_played>
},
"team_id": <fantasy_team_id>
}
]
}
EXAMPLE - Understanding the Different Data Types:
If a team shows:
- raw_averages.ast: 25.3 → Team averages 25.3 assists per game (actual performance)
- ranking_stats.ast: 12.0 → Team earned 12 ranking points in assists (1st place in 12-team league)
- category_ranks.AST: 1 → Team is ranked 1st in assists category
NOTES:
- Higher ranking_stats values = more points earned = better
- Lower category_ranks values = better position (1 is first place)
- raw_averages are the actual statistical performance
- GP (games played) is informational only, not used in ranking calculations
- When referring to steals in Hebrew, use חטיפות (not גניבות)
| `scripts.tools.getTeamDetails` |
|
Get league-wide shooting statistics (field goals and free throws) for all teams.
This endpoint provides CUMULATIVE TOTALS (not per-game averages) for shooting stats.
Useful for understanding overall team shooting efficiency across the season.
Returns:
A dictionary containing league-wide shooting statistics: {
"shots": [
{
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"fgm": <total_field_goals_made>,
"fga": <total_field_goals_attempted>,
"fg_percentage": <calculated_field_goal_percentage_as_decimal>,
"ftm": <total_free_throws_made>,
"fta": <total_free_throws_attempted>,
"ft_percentage": <calculated_free_throw_percentage_as_decimal>,
"gp": <games_played>
}
]
}
NOTES:
- fgm, fga, ftm, fta are TOTALS across all games, not per-game averages
- fg_percentage and ft_percentage are calculated from totals (fgm/fga, ftm/fta)
- Percentages are returned as decimals (e.g., 0.456 = 45.6%)
- The list contains one entry per team with their complete shooting profile
| `scripts.tools.getLeagueShotsStats` |
**如果参数不完整，使用 AskUserQuestion 向用户询问缺失的参数。**
---
## 工具函数说明
---
## scripts.tools.getAveragesLeagueRankings
工具描述：
Get the average league rankings from the API.
IMPORTANT - SCORING SYSTEM EXPLANATION:
This is a ROTISSERIE (ROTO) fantasy league. Teams earn ranking points in 8 categories.
CRITICAL: Do NOT confuse "ranking points" with "rank position"!
- Category values (fg_percentage, ast, reb, etc.) = POINTS earned (higher is better)
- The "rank" field = actual position/place in standings (1 = first place)
HOW RANKING POINTS WORK:
- In each category, teams are ranked 1st to Nth (where N = number of teams)
- Best team in a category gets N points, second-best gets N-1, worst gets 1
- Example in 12-team league: 1st place = 12 pts, 2nd = 11 pts, ..., 12th = 1 pt
- total_points = sum of points from all 8 categories
- Overall "rank" is determined by total_points (highest total = rank 1)
EXAMPLE in a 12-team league:
{
"team": {"team_name": "Best Team"},
"ast": 12.0, // Earned 12 pts (1st place in assists)
"reb": 11.0, // Earned 11 pts (2nd place in rebounds)
"stl": 8.0, // Earned 8 pts (5th place in steals)
...other categories...
"total_points": 73.0, // Sum of all 8 category points
"rank": 1, // Overall standing: 1st place
"GP": 55 // Games played (informational only, not ranked)
}
Args:
order: Sort order for rankings.
- "desc" = best to worst (top teams first, "from top to bottom", "מלמעלה למטה")
- "asc" = worst to best (bottom teams first, "from bottom to top", "מלמטה למעלה")
Default is "desc".
Returns:
A list of teams with their rankings, total points, and stats per category.
Each item in the list is a dictionary with the following keys: {
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"fg_percentage": <ranking_points_for_field_goal_percentage>,
"ft_percentage": <ranking_points_for_free_throw_percentage>,
"three_pm": <ranking_points_for_three_pointers_made>,
"ast": <ranking_points_for_assists>,
"reb": <ranking_points_for_rebounds>,
"stl": <ranking_points_for_steals>,
"blk": <ranking_points_for_blocks>,
"pts": <ranking_points_for_points>,
"total_points": <sum_of_all_category_ranking_points>,
"rank": <overall_position_1_is_first_place>,
"GP": <games_played_not_ranked>
}
NOTES:
- Higher values in categories = better performance (more ranking points earned)
- "rank" field is opposite: lower number = better (1 is first place)
- GP (games played) is informational only, not used in scoring
- When referring to steals in Hebrew, use חטיפות (not גניבות)
- If you refer to comparing teams, distinguish between rank and total points, so f.e someone can be 1st place 70 total points and another team can be 2nd place 69 total points.
- In that case, the difference is 2 points, not 1 place.
### 参数定义
|参数名称|参数类型|是否必填|默认值|描述|
|------|-------|------|-----|----|
|order|string|false|"desc"|null|
---
## scripts.tools.getTeams
工具描述：
Get the list of all teams in the fantasy league.
Use this endpoint to discover team IDs for use with other endpoints like getTeamDetails().
Returns:
A list of teams with their team_id and team_name.
Each item in the list is a dictionary with the following keys: {
"team_id": <integer_team_identifier>,
"team_name": <string_team_name>
}
NOTES:
- Team IDs are required for getTeamDetails(team_id)
- Team names may contain emojis or special characters
- The list includes all active teams in the league
### 参数定义
|参数名称|参数类型|是否必填|默认值|描述|
|------|-------|------|-----|----|
---
## scripts.tools.getAverageStats
工具描述：
Get the average statistics (actual performance numbers) for all teams from the API.
IMPORTANT: This returns ACTUAL PERFORMANCE STATS, NOT ranking points!
- This is different from getAveragesLeagueRankings() which returns ranking points
- Use this endpoint to see actual per-game averages (e.g., 25.3 assists per game)
- Use getAveragesLeagueRankings() to see rotisserie ranking points (e.g., 12 points earned)
Args:
use_normalized: If True, returns normalized data (0-1 scale) for comparison.
If False, returns raw statistical values (e.g., 45.6% FG, 12.3 AST).
Default is False.
Returns:
A list of teams with their actual statistical averages per game.
Each item in the list is a dictionary with the following structure:
{
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"stats": {
"FG%": <field_goal_percentage_as_decimal>,
"FT%": <free_throw_percentage_as_decimal>,
"3PM": <three_pointers_made_per_game>,
"AST": <assists_per_game>,
"REB": <rebounds_per_game>,
"STL": <steals_per_game>,
"BLK": <blocks_per_game>,
"PTS": <points_per_game>,
"GP": <games_played>
}
}
NOTES:
- Percentages are decimals (0.456 = 45.6%)
- All counting stats (3PM, AST, REB, STL, BLK, PTS) are per-game averages
- When use_normalized=True, all values are scaled 0-1 for heatmap visualization
- GP (games played) is a total count, not an average
### 参数定义
|参数名称|参数类型|是否必填|默认值|描述|
|------|-------|------|-----|----|
|use_normalized|boolean|false|false|null|
---
## scripts.tools.getTeamDetails
工具描述：
Get comprehensive details for a specific team from the API.
This endpoint combines multiple data types for a single team:
1. Raw statistical averages (actual performance numbers)
2. Ranking points (rotisserie scoring system)
3. Category ranks (position in each category, 1=best)
4. Player roster with individual stats
IMPORTANT - Understanding the Data Sections:
"raw_averages" = Actual statistical performance (e.g., 45.6% FG, 12.3 assists per game)
"ranking_stats" = Rotisserie points earned in each category (see explanation below)
"category_ranks" = Ordinal position in each category (1=1st place, 2=2nd place, etc.)
"shot_chart" = Raw totals for field goals and free throws (not averages)
RANKING STATS EXPLANATION (Same as getAveragesLeagueRankings):
This is a ROTISSERIE (ROTO) fantasy league. Teams earn ranking points in 8 categories.
CRITICAL: Do NOT confuse "ranking points" with "category ranks"!
- ranking_stats values (e.g., ast: 12.0) = POINTS earned (higher is better)
- category_ranks values (e.g., AST: 1) = position/place (lower is better, 1 = first)
HOW RANKING POINTS WORK:
- In each category, teams are ranked 1st to Nth (where N = number of teams)
- Best team in a category gets N points, second-best gets N-1, worst gets 1
- Example in 12-team league: 1st place = 12 pts, 2nd = 11 pts, ..., 12th = 1 pt
- total_points = sum of points from all 8 categories
- Overall "rank" is determined by total_points (highest total = rank 1)
Args:
team_id: The ID of the team to get details for. Use getTeams() to see all team IDs.
Returns:
A dictionary containing comprehensive team information: {
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"espn_url": <espn_team_page_url_string>,
"shot_chart": {
"team": {"team_id": <id>, "team_name": <name>},
"fgm": <total_field_goals_made>,
"fga": <total_field_goals_attempted>,
"fg_percentage": <calculated_field_goal_percentage_as_decimal>,
"ftm": <total_free_throws_made>,
"fta": <total_free_throws_attempted>,
"ft_percentage": <calculated_free_throw_percentage_as_decimal>,
"gp": <games_played>
},
"raw_averages": {
"fg_percentage": <average_field_goal_percentage_as_decimal>,
"ft_percentage": <average_free_throw_percentage_as_decimal>,
"three_pm": <average_three_pointers_made_per_game>,
"ast": <average_assists_per_game>,
"reb": <average_rebounds_per_game>,
"stl": <average_steals_per_game>,
"blk": <average_blocks_per_game>,
"pts": <average_points_per_game>,
"gp": <games_played>,
"team": {"team_id": <id>, "team_name": <name>}
},
"ranking_stats": {
"team": {"team_id": <id>, "team_name": <name>},
"fg_percentage": <ranking_points_earned_in_fg_percentage>,
"ft_percentage": <ranking_points_earned_in_ft_percentage>,
"three_pm": <ranking_points_earned_in_three_pointers>,
"ast": <ranking_points_earned_in_assists>,
"reb": <ranking_points_earned_in_rebounds>,
"stl": <ranking_points_earned_in_steals>,
"blk": <ranking_points_earned_in_blocks>,
"pts": <ranking_points_earned_in_points>,
"gp": <games_played_not_ranked>,
"total_points": <sum_of_all_8_category_ranking_points>,
"rank": <overall_standing_1_is_first_place>
},
"category_ranks": {
"FG%": <ranking_points_earned_in_fg_percentage>,
"FT%": <ranking_points_earned_in_ft_percentage>,
"3PM": <ranking_points_earned_in_three_pointers>,
"AST": <ranking_points_earned_in_assists>,
"REB": <ranking_points_earned_in_rebounds>,
"STL": <ranking_points_earned_in_steals>,
"BLK": <ranking_points_earned_in_blocks>,
"PTS": <ranking_points_earned_in_points>
},
"players": [
{
"player_name": <player_full_name_string>,
"pro_team": <nba_team_abbreviation_string>,
"positions": <list_of_eligible_positions>,
"stats": {
"pts": <average_points_per_game>,
"reb": <average_rebounds_per_game>,
"ast": <average_assists_per_game>,
"stl": <average_steals_per_game>,
"blk": <average_blocks_per_game>,
"fgm": <average_field_goals_made_per_game>,
"fga": <average_field_goals_attempted_per_game>,
"ftm": <average_free_throws_made_per_game>,
"fta": <average_free_throws_attempted_per_game>,
"fg_percentage": <field_goal_percentage_as_decimal>,
"ft_percentage": <free_throw_percentage_as_decimal>,
"three_pm": <average_three_pointers_made_per_game>,
"minutes": <average_minutes_per_game>,
"gp": <total_games_played>
},
"team_id": <fantasy_team_id>
}
]
}
EXAMPLE - Understanding the Different Data Types:
If a team shows:
- raw_averages.ast: 25.3 → Team averages 25.3 assists per game (actual performance)
- ranking_stats.ast: 12.0 → Team earned 12 ranking points in assists (1st place in 12-team league)
- category_ranks.AST: 1 → Team is ranked 1st in assists category
NOTES:
- Higher ranking_stats values = more points earned = better
- Lower category_ranks values = better position (1 is first place)
- raw_averages are the actual statistical performance
- GP (games played) is informational only, not used in ranking calculations
- When referring to steals in Hebrew, use חטיפות (not גניבות)
### 参数定义
|参数名称|参数类型|是否必填|默认值|描述|
|------|-------|------|-----|----|
|team_id|integer|true| |null|
---
## scripts.tools.getLeagueShotsStats
工具描述：
Get league-wide shooting statistics (field goals and free throws) for all teams.
This endpoint provides CUMULATIVE TOTALS (not per-game averages) for shooting stats.
Useful for understanding overall team shooting efficiency across the season.
Returns:
A dictionary containing league-wide shooting statistics: {
"shots": [
{
"team": {
"team_id": <team_id>,
"team_name": <team_name>
},
"fgm": <total_field_goals_made>,
"fga": <total_field_goals_attempted>,
"fg_percentage": <calculated_field_goal_percentage_as_decimal>,
"ftm": <total_free_throws_made>,
"fta": <total_free_throws_attempted>,
"ft_percentage": <calculated_free_throw_percentage_as_decimal>,
"gp": <games_played>
}
]
}
NOTES:
- fgm, fga, ftm, fta are TOTALS across all games, not per-game averages
- fg_percentage and ft_percentage are calculated from totals (fgm/fga, ftm/fta)
- Percentages are returned as decimals (e.g., 0.456 = 45.6%)
- The list contains one entry per team with their complete shooting profile
### 参数定义
|参数名称|参数类型|是否必填|默认值|描述|
|------|-------|------|-----|----|
---
---
## 返回值处理
工具函数返回 `dict` 对象：
- `result["raw"]` - API 原始返回数据（JSON），**直接将此数据整理后展示给用户**
- `result["success"]` - 是否成功（True/False）
- `result["message"]` - 状态消息
---
## 项目结构
```
xiaobenyang_gaokao_skill/
├── scripts/
│ ├── __init__.py
│ ├── config.py # 配置管理 + set_api_key()
│ ├── call_api.py # API 客户端 + call_api()
│ └── tools.py # 工具函数（直接调用）
├── requirements.txt
└── SKILL.md
```
---
## 注意事项
1. **API 密钥是必需的**，无密钥时必须通过 AskUserQuestion 询问用户
2. **禁止**在缺少 API 密钥时自行搜索或编造数据don't have the plugin yet? install it then click "run inline in claude" again.