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

README.md

@@ -1413,6 +1413,28 @@ The following sets of tools are available:
   - `repo`: Repository name (string, required)
   - `tag`: Tag name (string, required)
 
+- **get_traffic_clones** - Get repository traffic clones
+  - **OAuth Challenge Scopes**: `repo`
+  - `owner`: Repository owner (string, required)
+  - `per`: The time frame to aggregate by. Either 'day' or 'week'. Defaults to 'day'. (string, optional)
+  - `repo`: Repository name (string, required)
+
+- **get_traffic_paths** - Get repository traffic paths
+  - **OAuth Challenge Scopes**: `repo`
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+
+- **get_traffic_referrers** - Get repository traffic referrers
+  - **OAuth Challenge Scopes**: `repo`
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+
+- **get_traffic_views** - Get repository traffic views
+  - **OAuth Challenge Scopes**: `repo`
+  - `owner`: Repository owner (string, required)
+  - `per`: The time frame to aggregate by. Either 'day' or 'week'. Defaults to 'day'. (string, optional)
+  - `repo`: Repository name (string, required)
+
 - **list_branches** - List branches
   - **OAuth Challenge Scopes**: `repo`
   - `owner`: Repository owner (string, required)

pkg/github/__toolsnaps__/get_traffic_clones.snap

@@ -0,0 +1,34 @@
+{
+  "annotations": {
+    "idempotentHint": false,
+    "readOnlyHint": true,
+    "title": "Get repository traffic clones"
+  },
+  "description": "Get the total git clones and unique cloners for a GitHub repository over the last 14 days. Requires push access to the repository.",
+  "inputSchema": {
+    "properties": {
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "per": {
+        "description": "The time frame to aggregate by. Either 'day' or 'week'. Defaults to 'day'.",
+        "enum": [
+          "day",
+          "week"
+        ],
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "get_traffic_clones"
+}

pkg/github/__toolsnaps__/get_traffic_paths.snap

@@ -0,0 +1,26 @@
+{
+  "annotations": {
+    "idempotentHint": false,
+    "readOnlyHint": true,
+    "title": "Get repository traffic paths"
+  },
+  "description": "Get the top 10 most-visited paths (pages) for a GitHub repository over the last 14 days. Requires push access to the repository.",
+  "inputSchema": {
+    "properties": {
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "get_traffic_paths"
+}

pkg/github/__toolsnaps__/get_traffic_referrers.snap

@@ -0,0 +1,26 @@
+{
+  "annotations": {
+    "idempotentHint": false,
+    "readOnlyHint": true,
+    "title": "Get repository traffic referrers"
+  },
+  "description": "Get the top 10 referring sites (sources of traffic) for a GitHub repository over the last 14 days. Requires push access to the repository.",
+  "inputSchema": {
+    "properties": {
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "get_traffic_referrers"
+}

pkg/github/__toolsnaps__/get_traffic_views.snap

@@ -0,0 +1,34 @@
+{
+  "annotations": {
+    "idempotentHint": false,
+    "readOnlyHint": true,
+    "title": "Get repository traffic views"
+  },
+  "description": "Get the total page views and unique visitors for a GitHub repository over the last 14 days. Requires push access to the repository.",
+  "inputSchema": {
+    "properties": {
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "per": {
+        "description": "The time frame to aggregate by. Either 'day' or 'week'. Defaults to 'day'.",
+        "enum": [
+          "day",
+          "week"
+        ],
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      }
+    },
+    "required": [
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "get_traffic_views"
+}

pkg/github/helper_test.go

@@ -109,6 +109,12 @@ const (
 	GetReposReleasesLatestByOwnerByRepo    = "GET /repos/{owner}/{repo}/releases/latest"
 	GetReposReleasesTagsByOwnerByRepoByTag = "GET /repos/{owner}/{repo}/releases/tags/{tag}"
 
+	// Traffic endpoints
+	GetReposTrafficViewsByOwnerByRepo            = "GET /repos/{owner}/{repo}/traffic/views"
+	GetReposTrafficClonesByOwnerByRepo           = "GET /repos/{owner}/{repo}/traffic/clones"
+	GetReposTrafficPopularReferrersByOwnerByRepo = "GET /repos/{owner}/{repo}/traffic/popular/referrers"
+	GetReposTrafficPopularPathsByOwnerByRepo     = "GET /repos/{owner}/{repo}/traffic/popular/paths"
+
 	// Code quality endpoints
 	GetReposCodeQualityFindingsByOwnerByRepoByFindingNumber = "GET /repos/{owner}/{repo}/code-quality/findings/{finding_number}"