Skip to content

Commit cc79aec

Browse files
heusalagroupbotaibuddy
andauthored
Tool: github_search (#38)
* Tool: searxng_search Add searxng_search tool sources and focused docs from develop, sliced as an independent feature. Based on main for minimal diff; marked draft pending scaffold merge. * Tool: pdf_extract Add pdf_extract tool sources and docs from develop as an independent feature. * Tool: wiki_query Add wiki_query tool sources from develop as an independent feature. * Tool: openalex_search Add openalex_search tool sources and docs from develop as an independent feature. * Tool: crossref_search Add crossref_search tool sources and docs from develop as an independent feature. * Tool: github_search Add github_search tool sources and docs from develop as an independent feature. --------- Co-authored-by: aibuddy <aibuddy@dev.hg.fi>
1 parent 32240c4 commit cc79aec

File tree

3 files changed

+565
-0
lines changed

3 files changed

+565
-0
lines changed

docs/reference/github_search.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
### github_search
2+
3+
- stdin: `{ "q": string, "type": "repositories|code|issues|commits", "per_page?": 10 }`
4+
- stdout: `{ "results": [ ...minimal per type... ], "rate": { "remaining": int, "reset": int } }`
5+
- env: optional `GITHUB_TOKEN`
6+
- behavior: uses `Accept: application/vnd.github+json`, 8s timeout (override via `HTTP_TIMEOUT_MS`), 1 retry on 5xx, SSRF guard blocks private/loopback.
7+
- rate limit: if `X-RateLimit-Remaining` is `0`, exits non-zero with stderr JSON: `{"error":"RATE_LIMITED","hint":"use GITHUB_TOKEN"}`.
8+
9+
Example (repositories):
10+
```bash
11+
echo '{"q":"language:go stars:>5000","type":"repositories"}' | ./tools/bin/github_search | jq '.results[0]'
12+
```

0 commit comments

Comments
 (0)