Hacktoberfest 2026:維護者為十月標記出來的 issue,仍然開放、適合新手。 瀏覽 Hacktoberfest issue

Add repository traffic/insights tools (views, clones, referrers, paths)

未關閉
#3,164 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度
3/5
預估耗時
1-2 天
新手友好度
76/100
Issue 類型
功能
描述清晰度
基本清楚
活躍度
活躍
技術堆疊
github, go
領域
api, backend

研究方向

先閱讀 repos 工具集中的現有工具,以及固定版本 go-github 中的 ListTrafficViews、ListTrafficClones、ListTrafficReferrers 和 ListTrafficPaths 方法。新增這四個唯讀工具,並使用所述參數和儲存庫範圍要求;然後驗證 views 和 clones 接受按日或按週的細分,而 referrers 和 paths 不接受。

由索引模型根據 Issue 內容生成。

描述

request ai review
Describe the feature or problem you'd like to solve

The server has no way to read a repository's traffic/insights data. There are no tools wrapping the four traffic endpoints:

Proposed tool GitHub endpoint Returns
get_traffic_views GET /repos/{owner}/{repo}/traffic/views Page views + unique visitors (14-day, daily or weekly)
get_traffic_clones GET /repos/{owner}/{repo}/traffic/clones Git clones + unique cloners (14-day, daily or weekly)
get_traffic_referrers GET /repos/{owner}/{repo}/traffic/popular/referrers Top 10 referring sites
get_traffic_paths GET /repos/{owner}/{repo}/traffic/popular/paths Top 10 most-visited paths

Today an agent can read stars and forks but has no view into whether a repo is actually being visited or cloned, which is the primary signal for measuring adoption and reach of a project. This is a read-only capability.

Proposed solution

Add the four tools above under the existing repos toolset, each ReadOnlyHint: true.

The implementation is thin because the pinned go-github client already exposes all four methods (RepositoriesService.ListTrafficViews, ListTrafficClones, ListTrafficReferrers, ListTrafficPaths), so no new HTTP plumbing is needed. The views/clones tools take an optional per parameter (day | week) mapping to TrafficBreakdownOptions; referrers/paths take just owner/repo.

One note on access: GitHub gates these endpoints behind push access to the repo (for GitHub Apps, the repository Administration: Read permission), so the tools should be annotated to require the repo scope rather than treated as public-read, even though the endpoints exist on public repos.

I'm happy to open a PR for this if the capability is something you'd accept.

Example prompts or workflows (for tools/toolsets only)
  1. "How many unique visitors and clones did owner/repo get in the last two weeks?"
  2. "Where is traffic to my repo coming from? Show me the top referrers."
  3. "Which pages/paths in owner/repo are people actually viewing?"
  4. "Compare views vs. clones week over week for owner/repo and tell me if adoption is trending up."
  5. "Build me a weekly adoption report for my repo: stars, forks, views, unique visitors, and clones." (traffic is the missing piece today; stars/forks are already covered)
Additional context

Traffic data has a 14-day rolling retention window on GitHub's side, so these tools are especially useful to agents that snapshot the data on a schedule for longer-term trend tracking.

主要語言
Go
星號
33.1k
分支
5k
平均合併
2 天 3 小時
30 天內合併 PR
18

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

github/github-mcp-server 的其他 Issue

查看 github/github-mcp-server 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。