Skip to content

Commit 8389da9

Browse files
authored
Merge pull request #69 from MaekBlack/main
feat
2 parents 22647bd + 366a7e2 commit 8389da9

File tree

8 files changed

+110
-0
lines changed

8 files changed

+110
-0
lines changed
10.3 KB
Binary file not shown.

tools/tool_github_search/README.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# GitHub API 查询工具
2+
3+
查询 GitHub 仓库信息、Issues、Pull Requests、Releases 和贡献者数据。
4+
5+
## 功能特点
6+
7+
- 仓库基本信息查询
8+
- Issues/PRs 查询
9+
- Releases 查询
10+
- 贡献者查询
11+
- 支持 Token 认证
12+
13+
## 参数说明
14+
15+
**输入参数**: owner, repo, query_type, state, per_page
16+
```python
17+
def query_github_repository(
18+
owner: str,
19+
repo: str,
20+
query_type: str,
21+
state: str,
22+
token: Optional[str] = None,
23+
per_page: int = 10,
24+
page: int = 1
25+
) -> Dict[str, Any]:
26+
"""查询 GitHub 仓库信息
27+
28+
Args:
29+
owner: 仓库所有者(用户名或组织名)
30+
repo: 仓库名称
31+
token: GitHub Personal Access Token(可选,用于提高速率限制)
32+
query_type: 查询类型,可选 "info"/"issues"/"pulls"/"releases"/"contributors"
33+
state: 状态过滤,可选 "open"/"closed"/"all",默认 "open"
34+
per_page: 每页结果数,默认 10
35+
page: 页码,默认 1
36+
37+
Returns:
38+
Dict[str, Any]: 包含查询结果的字典,结构如下:
39+
- success (bool): 是否成功
40+
- data (Dict|None): 查询数据,包含:
41+
- type (str): 查询类型
42+
- repository (str): 仓库全名
43+
- info (Dict|None): 仓库基本信息
44+
- items (List|None): 结果列表(issues/prs/releases 等)
45+
- total_count (int): 总数
46+
- message (str): 结果消息
47+
48+
Raises:
49+
无异常抛出,所有错误在返回值中处理
50+
51+
Examples:
52+
>>> result = query_github_repository("1Panel-dev", "MaxKB", query_type="info")
53+
>>> if result["success"]:
54+
... print(f"Stars: {result['data']['info']['stargazers_count']}")
55+
"""
56+
```
57+
**启动参数**: token (可选)
58+
59+
## 使用说明
60+
61+
无需 Token 即可查询公开仓库,提供 Token 可提高速率限制。

tools/tool_github_search/data.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
name: GitHub API 查询
2+
tags:
3+
- 联网搜索
4+
title: GitHub API 查询工具
5+
description: 查询 GitHub 仓库信息、Issues、Pull Requests、Releases、贡献者等数据,支持仓库基本信息统计和动态查询

tools/tool_github_search/logo.png

497 Bytes
Loading
2.63 KB
Binary file not shown.

tools/tool_jina_reader/README.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# Jina Reader 工具
2+
3+
使用 Jina AI Reader 将 URL 转换为 LLM 友好的 Markdown 格式。
4+
5+
## 功能特点
6+
7+
- URL 转 Markdown
8+
- 智能内容提取
9+
- 自动清理噪音
10+
- 支持中文优化
11+
12+
## 参数说明
13+
14+
**输入参数**: url, return_format
15+
```python
16+
def read_url_with_jina(
17+
url: str,
18+
return_format: str,
19+
api_key: Optional[str] = None
20+
) -> Dict[str, Any]:
21+
"""使用 Jina Reader 读取 URL 内容
22+
23+
Args:
24+
url: 要读取的网页 URL
25+
api_key: Jina API 密钥 (可选)
26+
return_format: 返回格式 markdown/html
27+
28+
Returns:
29+
Dict[str, Any]: 包含读取结果的字典
30+
"""
31+
```
32+
**启动参数**: api_key (可选)
33+
34+
## 使用示例
35+
36+
```
37+
url: https://example.com/article
38+
return_format: markdown
39+
```

tools/tool_jina_reader/data.yaml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
name: Jina Reader
2+
tags:
3+
- 内容处理
4+
title: Jina AI Reader
5+
description: 使用 Jina AI Reader 将任意 URL 转换为 LLM 友好的 Markdown 格式,支持全文提取和智能清理

tools/tool_jina_reader/logo.png

245 Bytes
Loading

0 commit comments

Comments
 (0)