capacity-web 1.0.3

网络搜索功能包，提供简单易用的网络搜索接口

Capacity Web Search

网络搜索功能包，提供简单易用的网络搜索接口。

🚀 快速开始

安装

pip install capacity-web

使用

from capacity_web import search_web

# 基础搜索
result = search_web("人工智能最新发展")
if result["success"]:
    print(f"找到 {result['data']['number_of_results']} 条结果")
    for item in result["data"]["results"]:
        print(f"标题: {item['title']}")
        print(f"链接: {item['url']}")
        print(f"摘要: {item['content'][:100]}...")
        print(f"评分: {item['score']}")
        print("---")

# 高级搜索
result = search_web(
    "Python教程",
    language="zh",
    max_results=10,
    categories=["general"],
    time_range="year"
)

📋 API 文档

search_web(query, language="all", max_results=None, **kwargs)

进行网络搜索。

参数:

• query (str): 搜索关键词，必填
• language (str): 语言代码，默认 "all"
• max_results (int): 最大结果数量，1-100之间
• **kwargs: 高级选项

返回:

{
    "success": bool,                    # 是否成功
    "data": {                          # 搜索结果数据
        "query": str,                  # 查询词
        "number_of_results": int,      # 结果数量
        "results": [                   # 搜索结果列表
            {
                "url": str,            # 网页链接
                "title": str,          # 网页标题
                "content": str,        # 内容摘要
                "engine": str,         # 搜索引擎
                "score": float,        # 相关性评分
                "category": str,       # 结果类别
                # ...更多字段
            }
        ],
        "answers": list,               # 直接答案
        "suggestions": list,           # 搜索建议
        "corrections": list,           # 查询纠正
        "infoboxes": list,            # 信息框
        "unresponsive_engines": list   # 无响应引擎
    },
    "message": str                     # 状态信息
}

✨ 特性

• 统一返回格式: 所有API都返回 {"success": bool, "data": dict, "message": str} 格式
• 自动重试: 网络异常时自动重试，最多3次，指数退避
• 完整错误处理: 捕获所有网络、HTTP、验证错误
• AI友好: 简洁的API设计，易于理解和使用
• 类型提示: 完整的类型注解支持

🔧 高级选项

result = search_web(
    "搜索词",
    language="zh",                    # 语言: "zh", "en", "all" 等
    max_results=20,                   # 最大结果数
    page_number=1,                    # 页码
    categories=["general", "news"],   # 搜索类别
    search_engines=["google", "bing"], # 搜索引擎
    time_range="month",               # 时间范围
    safe_search=1,                    # 安全搜索级别
    results_format="json"             # 结果格式
)

📊 规范兼容

本包遵循 Simen Capacity Package 脚本规范 v2.1：

• ✅ 功能导向设计: API以业务功能为核心
• ✅ 统一返回格式: 标准的成功/失败响应
• ✅ 完整错误处理: 网络、HTTP、验证异常全覆盖
• ✅ 自动重试机制: tenacity实现的指数退避重试
• ✅ AI友好接口: 清晰的函数签名和文档

📝 许可证

MIT License