github-talent-mcp 0.1.0__tar.gz

github_talent_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carolina Cherry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

github_talent_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: github-talent-mcp
+Version: 0.1.0
+Summary: MCP server for searching, scoring, and ranking GitHub developers for technical recruiting
+Author: Carolina Cherry
+License: MIT
+Project-URL: Homepage, https://github.com/carolinacherry/github-talent-mcp
+Project-URL: Repository, https://github.com/carolinacherry/github-talent-mcp
+Project-URL: Issues, https://github.com/carolinacherry/github-talent-mcp/issues
+Keywords: mcp,github,recruiting,developer-tools,claude
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# github-talent-mcp
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.14+](https://img.shields.io/badge/Python-3.14+-blue.svg)](https://www.python.org)
+[![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-8A2BE2)](https://modelcontextprotocol.io)
+[![Claude](https://img.shields.io/badge/Built_for-Claude_by_Anthropic-d4a373)](https://claude.ai)
+[![GitHub API](https://img.shields.io/badge/GitHub-REST_API_v3-181717?logo=github)](https://docs.github.com/en/rest)
+
+MCP server that searches, scores, and ranks GitHub developers for technical recruiting.
+
+## Demo
+
+https://github.com/user-attachments/assets/2dfd82b4-3eb5-4f2b-bc0a-2580b95043e4
+
+### Profile deep dive
+
+> Get the full developer profile and activity score for torvalds on GitHub
+
+Claude calls `get_developer_profile("torvalds")` and returns:
+
+| Field | Value |
+|---|---|
+| **Activity Score** | **150** (reputation floor applied) |
+| Location | Portland, OR |
+| Followers | 293,321 |
+| Stars Received | 235,068 |
+| Primary Language | C (98.1%) |
+| Commits (90d) | 0 |
+| PRs (90d) | 0 |
+| Notable Repos | linux (183K stars), libdc-for-dirk, subsurface-for-dirk, uemacs, pesern-resolve |
+| Profile README | No |
+| Hireable | No |
+
+Torvalds has zero recent GitHub activity because kernel development flows through mailing lists, not GitHub PRs. The **reputation floor** (293K followers) overrides the behavioral score and sets it to 150.
+
+### Repo contributor ranking
+
+> Get the top contributors to huggingface/transformers and rank them for a founding ML engineer role at an AI startup
+
+Claude calls `get_repo_contributors("huggingface/transformers")` → `rank_candidates` on the top 24 contributors:
+
+| Rank | Developer | Combined Score | Activity | Relevance | Strengths |
+|---|---|---|---|---|---|
+| 1 | stas00 | 83.4 | 150 | 72 | 4,553 stars, contributes to major OSS, MIT-licensed repos |
+| 2 | cyyever | 80.8 | 120 | 64 | 1,217 followers, active contributor, profile README |
+| 3 | Cyrilvallez | 77.2 | 120 | 56 | Active: 13 commits + 57 PRs in 90 days, strong OSS presence |
+| 4 | ArthurZucker | 74.4 | 120 | 48 | 37 PRs in 90 days, contributes to huggingface/transformers |
+| 5 | ydshieh | 72.0 | 120 | 40 | Active: 9 commits + 40 PRs in 90 days |
+
+Combined score = activity × 0.4 + relevance × 0.6. Relevance is keyword overlap with the job description (ML, AI, startup, engineer, etc.).
+
+## Installation
+
+### 1. Clone and install
+
+```bash
+git clone https://github.com/carolinacherry/github-talent-mcp.git
+cd github-talent-mcp
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+### 2. Create a GitHub personal access token
+
+Go to [github.com/settings/tokens](https://github.com/settings/tokens) and create a **fine-grained** or **classic** token with these scopes:
+
+| Scope | Why |
+|---|---|
+| `read:user` | Read user profiles and search users |
+| `public_repo` | Read public repo data, languages, contributors |
+
+Create a `.env` file in the project root:
+
+```
+GITHUB_TOKEN=ghp_xxxxxxxxxxxx
+```
+
+### 3. Connect to Claude
+
+#### Claude Code (CLI)
+
+One command:
+
+```bash
+claude mcp add github-talent -- /path/to/github-talent-mcp/.venv/bin/python3 -m github_talent_mcp
+```
+
+Then set the token as an environment variable. Either:
+- Export it in your shell: `export GITHUB_TOKEN=ghp_xxxxxxxxxxxx`
+- Or keep it in the `.env` file — the server reads it via `python-dotenv` on startup
+
+Restart Claude Code to pick up the new server. Verify with `/mcp` — you should see 4 tools under `github-talent`.
+
+#### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "github-talent": {
+      "command": "/path/to/github-talent-mcp/.venv/bin/python3",
+      "args": ["-m", "github_talent_mcp"],
+      "cwd": "/path/to/github-talent-mcp",
+      "env": {
+        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The tools will appear in the toolbox icon.
+
+## Try It
+
+Once installed, paste these prompts to verify everything works:
+
+**Basic search:**
+> Find Python developers in Raleigh active in the last 60 days
+
+**Profile deep dive:**
+> Get the full developer profile and activity score for torvalds on GitHub
+
+**Full workflow:**
+> Find 10 ML engineers in San Francisco active in the last 30 days, then rank them for a senior LLM inference engineer role
+
+**Repo contributors:**
+> Get the top contributors to huggingface/transformers and rank them for a founding ML engineer role at an AI startup
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `search_developers` | Search GitHub users by language, location, activity, followers. For topic-based sourcing, use `get_repo_contributors` on relevant repos instead. |
+| `get_developer_profile` | Deep profile enrichment: languages, stars, commits + PRs, OSS contributions, license breakdown, profile README, and activity score with breakdown. |
+| `rank_candidates` | Rank usernames against a job description. Returns sorted candidates with combined score, strengths, gaps, and reasoning. |
+| `get_repo_contributors` | Top contributors for any repo. Accepts `owner/repo` or full URL. The fastest way to source for a specific domain. |
+
+## Scoring
+
+The activity score combines two layers: **behavioral signals** (what you did recently) and a **reputation floor** (what you've built over time).
+
+### Behavioral Score (0-205)
+
+| Signal | Max Points | How |
+|---|---|---|
+| Commits + PRs (last 90 days) | 60 | Push commits + PR opens (PRs weighted x3). Captures both push-based and PR-based workflows. |
+| Stars on repos | 40 | Personal repo stars + stars on repos you contribute to. Org repo maintainers get credit. |
+| Profile README | 20 | Presence of a profile README (github.com/username/username). |
+| Followers | 20 | Capped at 20. |
+| Repos with descriptions | 20 | Ratio of repos that have descriptions. Signal of care and polish. |
+| Permissive license repos | 15 | Has at least one repo with MIT, Apache-2.0, BSD, ISC, or Unlicense. |
+| Major OSS contributions | 30 | PRs, pushes, or issues on repos you don't own. Capped at 3 repos (10 pts each). |
+
+### Reputation Floor
+
+The behavioral score alone penalizes developers whose work doesn't produce GitHub events — Torvalds works through mailing lists, senior maintainers merge via org bots, and many engineers work in private repos.
+
+The reputation floor ensures cumulative impact isn't erased by a quiet quarter:
+
+| Threshold | Floor |
+|---|---|
+| 10K+ followers **or** 50K+ stars | 150 |
+| 1K+ followers **or** 5K+ stars | 120 |
+| 500+ followers **or** 1K+ stars | 100 |
+| 100+ followers **or** 200+ stars | 80 |
+
+The final score is `max(behavioral_score, reputation_floor)`. If the floor is applied, the breakdown includes a `reputation_floor` field so you know.
+
+### Score Tiers
+
+- **150+** — exceptional (top OSS maintainers, well-known engineers)
+- **120-149** — strong signal, worth reaching out
+- **80-119** — solid developer with meaningful public work
+- **40-79** — active but limited public signal
+- **<40** — low signal (likely private work or junior)
+
+### Ranking
+
+`rank_candidates` combines the activity score with a **relevance score** (0-100) based on keyword overlap between the job description and the candidate's profile (bio, languages, repo topics, README). The combined score weights relevance at 60% and activity at 40% — a high-activity developer with no overlap to the job shouldn't outrank a relevant one.
+
+## Rate Limits
+
+GitHub REST API: 5,000 requests/hour with token. A typical workflow (search + enrich 5 candidates + rank) uses ~60-100 API calls. Profile results are cached within a session to avoid redundant calls during ranking.
+
+## License
+
+MIT

github_talent_mcp-0.1.0/README.md

@@ -0,0 +1,189 @@
+# github-talent-mcp
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.14+](https://img.shields.io/badge/Python-3.14+-blue.svg)](https://www.python.org)
+[![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-8A2BE2)](https://modelcontextprotocol.io)
+[![Claude](https://img.shields.io/badge/Built_for-Claude_by_Anthropic-d4a373)](https://claude.ai)
+[![GitHub API](https://img.shields.io/badge/GitHub-REST_API_v3-181717?logo=github)](https://docs.github.com/en/rest)
+
+MCP server that searches, scores, and ranks GitHub developers for technical recruiting.
+
+## Demo
+
+https://github.com/user-attachments/assets/2dfd82b4-3eb5-4f2b-bc0a-2580b95043e4
+
+### Profile deep dive
+
+> Get the full developer profile and activity score for torvalds on GitHub
+
+Claude calls `get_developer_profile("torvalds")` and returns:
+
+| Field | Value |
+|---|---|
+| **Activity Score** | **150** (reputation floor applied) |
+| Location | Portland, OR |
+| Followers | 293,321 |
+| Stars Received | 235,068 |
+| Primary Language | C (98.1%) |
+| Commits (90d) | 0 |
+| PRs (90d) | 0 |
+| Notable Repos | linux (183K stars), libdc-for-dirk, subsurface-for-dirk, uemacs, pesern-resolve |
+| Profile README | No |
+| Hireable | No |
+
+Torvalds has zero recent GitHub activity because kernel development flows through mailing lists, not GitHub PRs. The **reputation floor** (293K followers) overrides the behavioral score and sets it to 150.
+
+### Repo contributor ranking
+
+> Get the top contributors to huggingface/transformers and rank them for a founding ML engineer role at an AI startup
+
+Claude calls `get_repo_contributors("huggingface/transformers")` → `rank_candidates` on the top 24 contributors:
+
+| Rank | Developer | Combined Score | Activity | Relevance | Strengths |
+|---|---|---|---|---|---|
+| 1 | stas00 | 83.4 | 150 | 72 | 4,553 stars, contributes to major OSS, MIT-licensed repos |
+| 2 | cyyever | 80.8 | 120 | 64 | 1,217 followers, active contributor, profile README |
+| 3 | Cyrilvallez | 77.2 | 120 | 56 | Active: 13 commits + 57 PRs in 90 days, strong OSS presence |
+| 4 | ArthurZucker | 74.4 | 120 | 48 | 37 PRs in 90 days, contributes to huggingface/transformers |
+| 5 | ydshieh | 72.0 | 120 | 40 | Active: 9 commits + 40 PRs in 90 days |
+
+Combined score = activity × 0.4 + relevance × 0.6. Relevance is keyword overlap with the job description (ML, AI, startup, engineer, etc.).
+
+## Installation
+
+### 1. Clone and install
+
+```bash
+git clone https://github.com/carolinacherry/github-talent-mcp.git
+cd github-talent-mcp
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+### 2. Create a GitHub personal access token
+
+Go to [github.com/settings/tokens](https://github.com/settings/tokens) and create a **fine-grained** or **classic** token with these scopes:
+
+| Scope | Why |
+|---|---|
+| `read:user` | Read user profiles and search users |
+| `public_repo` | Read public repo data, languages, contributors |
+
+Create a `.env` file in the project root:
+
+```
+GITHUB_TOKEN=ghp_xxxxxxxxxxxx
+```
+
+### 3. Connect to Claude
+
+#### Claude Code (CLI)
+
+One command:
+
+```bash
+claude mcp add github-talent -- /path/to/github-talent-mcp/.venv/bin/python3 -m github_talent_mcp
+```
+
+Then set the token as an environment variable. Either:
+- Export it in your shell: `export GITHUB_TOKEN=ghp_xxxxxxxxxxxx`
+- Or keep it in the `.env` file — the server reads it via `python-dotenv` on startup
+
+Restart Claude Code to pick up the new server. Verify with `/mcp` — you should see 4 tools under `github-talent`.
+
+#### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "github-talent": {
+      "command": "/path/to/github-talent-mcp/.venv/bin/python3",
+      "args": ["-m", "github_talent_mcp"],
+      "cwd": "/path/to/github-talent-mcp",
+      "env": {
+        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The tools will appear in the toolbox icon.
+
+## Try It
+
+Once installed, paste these prompts to verify everything works:
+
+**Basic search:**
+> Find Python developers in Raleigh active in the last 60 days
+
+**Profile deep dive:**
+> Get the full developer profile and activity score for torvalds on GitHub
+
+**Full workflow:**
+> Find 10 ML engineers in San Francisco active in the last 30 days, then rank them for a senior LLM inference engineer role
+
+**Repo contributors:**
+> Get the top contributors to huggingface/transformers and rank them for a founding ML engineer role at an AI startup
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `search_developers` | Search GitHub users by language, location, activity, followers. For topic-based sourcing, use `get_repo_contributors` on relevant repos instead. |
+| `get_developer_profile` | Deep profile enrichment: languages, stars, commits + PRs, OSS contributions, license breakdown, profile README, and activity score with breakdown. |
+| `rank_candidates` | Rank usernames against a job description. Returns sorted candidates with combined score, strengths, gaps, and reasoning. |
+| `get_repo_contributors` | Top contributors for any repo. Accepts `owner/repo` or full URL. The fastest way to source for a specific domain. |
+
+## Scoring
+
+The activity score combines two layers: **behavioral signals** (what you did recently) and a **reputation floor** (what you've built over time).
+
+### Behavioral Score (0-205)
+
+| Signal | Max Points | How |
+|---|---|---|
+| Commits + PRs (last 90 days) | 60 | Push commits + PR opens (PRs weighted x3). Captures both push-based and PR-based workflows. |
+| Stars on repos | 40 | Personal repo stars + stars on repos you contribute to. Org repo maintainers get credit. |
+| Profile README | 20 | Presence of a profile README (github.com/username/username). |
+| Followers | 20 | Capped at 20. |
+| Repos with descriptions | 20 | Ratio of repos that have descriptions. Signal of care and polish. |
+| Permissive license repos | 15 | Has at least one repo with MIT, Apache-2.0, BSD, ISC, or Unlicense. |
+| Major OSS contributions | 30 | PRs, pushes, or issues on repos you don't own. Capped at 3 repos (10 pts each). |
+
+### Reputation Floor
+
+The behavioral score alone penalizes developers whose work doesn't produce GitHub events — Torvalds works through mailing lists, senior maintainers merge via org bots, and many engineers work in private repos.
+
+The reputation floor ensures cumulative impact isn't erased by a quiet quarter:
+
+| Threshold | Floor |
+|---|---|
+| 10K+ followers **or** 50K+ stars | 150 |
+| 1K+ followers **or** 5K+ stars | 120 |
+| 500+ followers **or** 1K+ stars | 100 |
+| 100+ followers **or** 200+ stars | 80 |
+
+The final score is `max(behavioral_score, reputation_floor)`. If the floor is applied, the breakdown includes a `reputation_floor` field so you know.
+
+### Score Tiers
+
+- **150+** — exceptional (top OSS maintainers, well-known engineers)
+- **120-149** — strong signal, worth reaching out
+- **80-119** — solid developer with meaningful public work
+- **40-79** — active but limited public signal
+- **<40** — low signal (likely private work or junior)
+
+### Ranking
+
+`rank_candidates` combines the activity score with a **relevance score** (0-100) based on keyword overlap between the job description and the candidate's profile (bio, languages, repo topics, README). The combined score weights relevance at 60% and activity at 40% — a high-activity developer with no overlap to the job shouldn't outrank a relevant one.
+
+## Rate Limits
+
+GitHub REST API: 5,000 requests/hour with token. A typical workflow (search + enrich 5 candidates + rank) uses ~60-100 API calls. Profile results are cached within a session to avoid redundant calls during ranking.
+
+## License
+
+MIT

github_talent_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "github-talent-mcp"
+version = "0.1.0"
+description = "MCP server for searching, scoring, and ranking GitHub developers for technical recruiting"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "Carolina Cherry"},
+]
+keywords = ["mcp", "github", "recruiting", "developer-tools", "claude"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/carolinacherry/github-talent-mcp"
+Repository = "https://github.com/carolinacherry/github-talent-mcp"
+Issues = "https://github.com/carolinacherry/github-talent-mcp/issues"
+
+[project.scripts]
+github-talent-mcp = "github_talent_mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

github_talent_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

github_talent_mcp-0.1.0/src/github_talent_mcp/__main__.py

@@ -0,0 +1,3 @@
+from github_talent_mcp.server import main
+
+main()

github_talent_mcp-0.1.0/src/github_talent_mcp/github_client.py

@@ -0,0 +1,191 @@
+from __future__ import annotations
+
+import logging
+import os
+import time
+from typing import Any
+
+import httpx
+
+GITHUB_API = "https://api.github.com"
+PERMISSIVE_LICENSES = frozenset({
+    "mit", "apache-2.0", "bsd-2-clause", "bsd-3-clause", "isc", "unlicense",
+})
+
+log = logging.getLogger("github-talent-mcp")
+
+
+class GitHubClient:
+    def __init__(self, token: str | None = None):
+        self._token = token or os.environ.get("GITHUB_TOKEN", "")
+        self._cache: dict[str, tuple[float, Any]] = {}
+        self._cache_ttl = 300  # 5 minutes
+        headers: dict[str, str] = {
+            "Accept": "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+        }
+        if self._token:
+            headers["Authorization"] = f"Bearer {self._token}"
+        self._client = httpx.AsyncClient(
+            base_url=GITHUB_API,
+            headers=headers,
+            timeout=30.0,
+        )
+
+    async def close(self) -> None:
+        await self._client.aclose()
+
+    # -- Cache helpers --
+
+    def _cache_get(self, key: str) -> Any | None:
+        if key in self._cache:
+            ts, data = self._cache[key]
+            if time.monotonic() - ts < self._cache_ttl:
+                return data
+            del self._cache[key]
+        return None
+
+    def _cache_set(self, key: str, data: Any) -> None:
+        self._cache[key] = (time.monotonic(), data)
+
+    def _check_rate_limit(self, resp: httpx.Response) -> None:
+        remaining = resp.headers.get("X-RateLimit-Remaining")
+        if remaining and int(remaining) < 100:
+            reset = resp.headers.get("X-RateLimit-Reset", "unknown")
+            log.warning(f"Rate limit low: {remaining} remaining, resets at {reset}")
+
+    # -- API methods --
+
+    async def search_users(
+        self,
+        *,
+        languages: list[str] | None = None,
+        location: str | None = None,
+        min_followers: int | None = None,
+        min_repos: int | None = None,
+        per_page: int = 30,
+        page: int = 1,
+    ) -> dict:
+        parts: list[str] = ["type:user"]
+        if languages:
+            for lang in languages:
+                parts.append(f"language:{lang}")
+        if location:
+            parts.append(f"location:{location}")
+        if min_followers is not None:
+            parts.append(f"followers:>={min_followers}")
+        if min_repos is not None:
+            parts.append(f"repos:>={min_repos}")
+        # Note: pushed:> is NOT a valid qualifier for /search/users — it silently
+        # returns 0 results. Use created:> for account age filtering instead.
+        # Recent activity should be verified via get_developer_profile.
+
+        q = " ".join(parts)
+        resp = await self._client.get(
+            "/search/users",
+            params={"q": q, "per_page": per_page, "page": page, "sort": "followers", "order": "desc"},
+        )
+        self._check_rate_limit(resp)
+        resp.raise_for_status()
+        return resp.json()
+
+    async def get_repo_info(self, owner: str, repo: str) -> dict:
+        cache_key = f"repo:{owner}/{repo}"
+        cached = self._cache_get(cache_key)
+        if cached is not None:
+            return cached
+        resp = await self._client.get(f"/repos/{owner}/{repo}")
+        self._check_rate_limit(resp)
+        resp.raise_for_status()
+        data = resp.json()
+        self._cache_set(cache_key, data)
+        return data
+
+    async def get_user(self, username: str) -> dict:
+        cache_key = f"user:{username}"
+        cached = self._cache_get(cache_key)
+        if cached is not None:
+            return cached
+        resp = await self._client.get(f"/users/{username}")
+        self._check_rate_limit(resp)
+        resp.raise_for_status()
+        data = resp.json()
+        self._cache_set(cache_key, data)
+        return data
+
+    async def get_user_repos(self, username: str, per_page: int = 100) -> list[dict]:
+        cache_key = f"repos:{username}"
+        cached = self._cache_get(cache_key)
+        if cached is not None:
+            return cached
+        resp = await self._client.get(
+            f"/users/{username}/repos",
+            params={"per_page": per_page, "sort": "pushed", "direction": "desc", "type": "owner"},
+        )
+        self._check_rate_limit(resp)
+        resp.raise_for_status()
+        data = resp.json()
+        self._cache_set(cache_key, data)
+        return data
+
+    async def get_repo_languages(self, owner: str, repo: str) -> dict[str, int]:
+        cache_key = f"langs:{owner}/{repo}"
+        cached = self._cache_get(cache_key)
+        if cached is not None:
+            return cached
+        resp = await self._client.get(f"/repos/{owner}/{repo}/languages")
+        self._check_rate_limit(resp)
+        resp.raise_for_status()
+        data = resp.json()
+        self._cache_set(cache_key, data)
+        return data
+
+    async def get_user_events(self, username: str, max_pages: int = 3) -> list[dict]:
+        cache_key = f"events:{username}"
+        cached = self._cache_get(cache_key)
+        if cached is not None:
+            return cached
+        all_events: list[dict] = []
+        for page in range(1, max_pages + 1):
+            resp = await self._client.get(
+                f"/users/{username}/events/public",
+                params={"per_page": 100, "page": page},
+            )
+            self._check_rate_limit(resp)
+            resp.raise_for_status()
+            events = resp.json()
+            if not events:
+                break
+            all_events.extend(events)
+        self._cache_set(cache_key, all_events)
+        return all_events
+
+    async def get_profile_readme(self, username: str) -> str | None:
+        cache_key = f"readme:{username}"
+        cached = self._cache_get(cache_key)
+        if cached is not None:
+            return cached
+        try:
+            resp = await self._client.get(
+                f"/repos/{username}/{username}/readme",
+                headers={"Accept": "application/vnd.github.raw+json"},
+            )
+            if resp.status_code == 200:
+                content = resp.text[:3000]
+                self._cache_set(cache_key, content)
+                return content
+        except httpx.HTTPError:
+            pass
+        self._cache_set(cache_key, None)
+        return None
+
+    async def get_repo_contributors(
+        self, owner: str, repo: str, per_page: int = 30,
+    ) -> list[dict]:
+        resp = await self._client.get(
+            f"/repos/{owner}/{repo}/contributors",
+            params={"per_page": per_page},
+        )
+        self._check_rate_limit(resp)
+        resp.raise_for_status()
+        return resp.json()