🚀 使用指南
本指南详细介绍了搜索API、YouTube视频及字幕相关的使用方法，同时包含故障排除、许可证、致谢和资源等信息，助您顺利使用相关功能。
🚀 快速开始
本使用指南涵盖了搜索API、YouTube视频及字幕等功能的使用方法。您可以根据需求调用不同的API，并按照示例请求进行操作。若遇到问题，可参考故障排除部分。
✨ 主要特性
- 搜索API：支持Google搜索，可自定义查询内容、结果数量、国家代码、语言代码等参数。
- YouTube视频：可获取指定YouTube视频的详细信息。
- YouTube字幕：能获取指定YouTube视频的字幕，支持指定字幕语言。
📦 安装指南
文档中未提及安装步骤，暂不提供相关内容。
💻 使用示例
基础用法
搜索API - Google搜索
Google搜索API需要以下参数：
| 参数 | 详情 |
|---|---|
api_key |
用于身份验证的SerpAPI密钥 |
search_term |
要查询的内容 |
num |
要获取的结果数量（最大值为100） |
start |
结果的起始位置（从1开始） |
gl |
国家代码（例如，'us' - 美国，'uk' - 英国） |
hl |
语言代码（例如，'en' - 英语，'es' - 西班牙语） |
device |
设备类型（'desktop' - 台式机，'tablet' - 平板，'mobile' - 手机） |
filter |
过滤结果（1 - 启用类似结果和省略结果的过滤，0 - 禁用） |
示例请求代码如下：
import requests
url = "https://google.serper.dev/search"
params = {
"api_key": "your_api_key",
"search_term": "Python 教程",
"num": 10,
"start": 1,
"gl": "us",
"hl": "en"
}
response = requests.get(url, params=params)
print(response.json())
YouTube视频
获取YouTube视频信息需要以下参数：
| 参数 | 详情 |
|---|---|
v |
YouTube视频ID |
api_key |
SerpAPI密钥 |
示例请求代码如下：
import requests
url = "https://youtube.googleapis.com/v3/videos"
params = {
"part": "snippet,statistics",
"id": "your_video_id",
"key": "your_api_key"
}
response = requests.get(url, params=params)
print(response.json())
YouTube字幕
获取YouTube字幕需要以下参数：
| 参数 | 详情 |
|---|---|
video_url |
YouTube视频的URL或ID |
language |
要获取的字幕语言（默认为英语） |
示例请求代码如下：
import youtube_transcript_api
transcript = youtube_transcript_api.get_transcript(
"https://www.youtube.com/watch?v=your_video_id",
language="zh-CN"
)
print(transcript)
高级用法
文档中未提及高级用法相关内容，暂不提供。
📚 详细文档
故障排除
无效API密钥
- 确认在
.env文件中正确配置了API密钥。 - 检查SerpAPI控制台确认密钥是否激活。
- 排除密钥中包含引号或空格的可能性。
请求失败
- 检查网络连接。
- 确认未超过API调用配额。
- 验证请求参数格式正确。
- 检查是否有速率限制问题。
📄 许可证
本项目使用MIT许可证，详情请参阅LICENSE文件。
🔗 致谢
感谢以下项目的支持：
- SerpApi 提供了搜索API
- YouTube Transcript API 用于字幕检索
- MCP协议实现了AI助手的集成