fetchnode 0.6.0__tar.gz → 0.6.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. {fetchnode-0.6.0 → fetchnode-0.6.2}/CHANGELOG.md +30 -0
  2. {fetchnode-0.6.0 → fetchnode-0.6.2}/PKG-INFO +18 -3
  3. {fetchnode-0.6.0 → fetchnode-0.6.2}/README.md +16 -1
  4. {fetchnode-0.6.0 → fetchnode-0.6.2}/pyproject.toml +2 -2
  5. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/management/commands/fetchnode_mcp.py +2 -0
  6. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/mcp.py +80 -0
  7. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/version.py +1 -1
  8. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/commands/fetchnode_mcp.py +2 -0
  9. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/mcp.py +80 -0
  10. {fetchnode-0.6.0 → fetchnode-0.6.2}/.gitignore +0 -0
  11. {fetchnode-0.6.0 → fetchnode-0.6.2}/LICENSE +0 -0
  12. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/__init__.py +0 -0
  13. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/api.py +0 -0
  14. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/apps.py +0 -0
  15. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/capture.py +0 -0
  16. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/celery.py +0 -0
  17. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/conf.py +0 -0
  18. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/demo.py +0 -0
  19. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/excepthook.py +0 -0
  20. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/handlers.py +0 -0
  21. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/management/__init__.py +0 -0
  22. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/management/commands/__init__.py +0 -0
  23. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/middleware.py +0 -0
  24. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/py.typed +0 -0
  25. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/query.py +0 -0
  26. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/scope.py +0 -0
  27. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/scrub.py +0 -0
  28. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/sender.py +0 -0
  29. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/utils.py +0 -0
  30. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/__init__.py +0 -0
  31. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/api.py +0 -0
  32. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/apps.py +0 -0
  33. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/capture.py +0 -0
  34. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/celery.py +0 -0
  35. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/conf.py +0 -0
  36. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/demo.py +0 -0
  37. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/excepthook.py +0 -0
  38. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/handlers.py +0 -0
  39. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/__init__.py +0 -0
  40. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/commands/__init__.py +0 -0
  41. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/middleware.py +0 -0
  42. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/py.typed +0 -0
  43. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/query.py +0 -0
  44. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/scope.py +0 -0
  45. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/scrub.py +0 -0
  46. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/sender.py +0 -0
  47. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/utils.py +0 -0
  48. {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/version.py +0 -0
@@ -1,5 +1,35 @@
1
1
  # FetchNode SDK changelog
2
2
 
3
+ ## 0.6.2 — 2026-10-27
4
+
5
+ ### Added
6
+
7
+ - Google Keyword Planner & Search Volume integration: `get_keyword_search_volume` and `discover_keyword_ideas` MCP tools and Python SDK functions to query monthly Google search volumes, 12-month search trends, competition indices, and top-of-page bid estimates tailored to the website's focus market (e.g. US / English vs NL / Dutch).
8
+ - Google Autocomplete search intent expansions: `get_google_search_suggestions` retrieves real-time user query suggestions directly from Google.
9
+ - Core Web Vitals & Technical SEO audits: `get_pagespeed_opportunities` audits page speed, performance bottlenecks, and technical on-page SEO issues.
10
+ - Target market auto-inference: tools automatically resolve the target country and language from project telemetry, domain TLD, and configured market focus.
11
+
12
+ ### Upgrade
13
+
14
+ ```bash
15
+ python -m pip install --upgrade fetchnode==0.6.2
16
+ ```
17
+
18
+ ## 0.6.1 — 2026-10-22
19
+
20
+ ### Added
21
+
22
+ - Page analytics & bounce rate tracking: `get_page_analytics` MCP tool and Python SDK function to query top viewed pages, bounce rates per landing page, and identify high bounce pages (>= 50%).
23
+ - Conversion insights: page-level conversion rates, converters count, and attributed goal performance.
24
+ - Interactive MCP prompt: `audit_page_engagement_and_bounces` for AI coding agents to evaluate user engagement and suggest retention improvements.
25
+ - Updated agent configuration and documentation in `python manage.py fetchnode_mcp`.
26
+
27
+ ### Upgrade
28
+
29
+ ```bash
30
+ python -m pip install --upgrade fetchnode==0.6.1
31
+ ```
32
+
3
33
  ## 0.6.0 — 2026-10-19
4
34
 
5
35
  ### Added
@@ -1,12 +1,12 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: fetchnode
3
- Version: 0.6.0
3
+ Version: 0.6.2
4
4
  Summary: Official Django and Python client SDK for FetchNode monitoring
5
5
  Project-URL: Homepage, https://fetch-node.com
6
6
  Project-URL: Documentation, https://fetch-node.com/guide/
7
7
  Project-URL: Repository, https://github.com/remcovanwijk040/fetchnode
8
8
  Project-URL: Issues, https://github.com/remcovanwijk040/fetchnode/issues
9
- Project-URL: Changelog, https://pypi.org/project/fetchnode/0.6.0/#sdk-changelog
9
+ Project-URL: Changelog, https://pypi.org/project/fetchnode/0.6.1/#sdk-changelog
10
10
  Author-email: Remco van Wijk <remcovanwijk040@users.noreply.github.com>
11
11
  License-Expression: MIT
12
12
  License-File: LICENSE
@@ -72,7 +72,7 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
72
72
 
73
73
  ## Installation
74
74
 
75
- Version 0.6.0 adds SEO change experiment tracking, pre-crash user journeys, and monthly maintenance briefs to the Model Context Protocol (MCP) server.
75
+ Version 0.6.2 adds Google Keyword Planner monthly search volume, search intent suggestions, PageSpeed audits, and target market auto-inference to the Model Context Protocol (MCP) server.
76
76
  See the [SDK changelog](#sdk-changelog) for changes and upgrade instructions.
77
77
 
78
78
  Install via `pip`:
@@ -328,6 +328,21 @@ MIT License. See [LICENSE](LICENSE) for details.
328
328
 
329
329
  # SDK changelog
330
330
 
331
+ ## 0.6.1 — 2026-10-22
332
+
333
+ ### Added
334
+
335
+ - Page analytics & bounce rate tracking: `get_page_analytics` MCP tool and Python SDK function to query top viewed pages, bounce rates per landing page, and identify high bounce pages (>= 50%).
336
+ - Conversion insights: page-level conversion rates, converters count, and attributed goal performance.
337
+ - Interactive MCP prompt: `audit_page_engagement_and_bounces` for AI coding agents to evaluate user engagement and suggest retention improvements.
338
+ - Updated agent configuration and documentation in `python manage.py fetchnode_mcp`.
339
+
340
+ ### Upgrade
341
+
342
+ ```bash
343
+ python -m pip install --upgrade fetchnode==0.6.1
344
+ ```
345
+
331
346
  ## 0.6.0 — 2026-10-19
332
347
 
333
348
  ### Added
@@ -35,7 +35,7 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
35
35
 
36
36
  ## Installation
37
37
 
38
- Version 0.6.0 adds SEO change experiment tracking, pre-crash user journeys, and monthly maintenance briefs to the Model Context Protocol (MCP) server.
38
+ Version 0.6.2 adds Google Keyword Planner monthly search volume, search intent suggestions, PageSpeed audits, and target market auto-inference to the Model Context Protocol (MCP) server.
39
39
  See the [SDK changelog](#sdk-changelog) for changes and upgrade instructions.
40
40
 
41
41
  Install via `pip`:
@@ -291,6 +291,21 @@ MIT License. See [LICENSE](LICENSE) for details.
291
291
 
292
292
  # SDK changelog
293
293
 
294
+ ## 0.6.1 — 2026-10-22
295
+
296
+ ### Added
297
+
298
+ - Page analytics & bounce rate tracking: `get_page_analytics` MCP tool and Python SDK function to query top viewed pages, bounce rates per landing page, and identify high bounce pages (>= 50%).
299
+ - Conversion insights: page-level conversion rates, converters count, and attributed goal performance.
300
+ - Interactive MCP prompt: `audit_page_engagement_and_bounces` for AI coding agents to evaluate user engagement and suggest retention improvements.
301
+ - Updated agent configuration and documentation in `python manage.py fetchnode_mcp`.
302
+
303
+ ### Upgrade
304
+
305
+ ```bash
306
+ python -m pip install --upgrade fetchnode==0.6.1
307
+ ```
308
+
294
309
  ## 0.6.0 — 2026-10-19
295
310
 
296
311
  ### Added
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "fetchnode"
7
- version = "0.6.0"
7
+ version = "0.6.2"
8
8
  description = "Official Django and Python client SDK for FetchNode monitoring"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -47,7 +47,7 @@ Homepage = "https://fetch-node.com"
47
47
  Documentation = "https://fetch-node.com/guide/"
48
48
  Repository = "https://github.com/remcovanwijk040/fetchnode"
49
49
  Issues = "https://github.com/remcovanwijk040/fetchnode/issues"
50
- Changelog = "https://pypi.org/project/fetchnode/0.6.0/#sdk-changelog"
50
+ Changelog = "https://pypi.org/project/fetchnode/0.6.1/#sdk-changelog"
51
51
 
52
52
  [tool.hatch.build.targets.wheel]
53
53
  packages = ["src/fetchnode", "src/fetchnode_client"]
@@ -201,11 +201,13 @@ class Command(BaseCommand):
201
201
  " - **Speed & Bottlenecks**: `get_performance_bottlenecks`\n"
202
202
  " - **SEO & Search Console**: `get_seo_overview`, `get_keyword_opportunities`, `get_page_performance`, `get_declining_pages`, `get_technical_seo_health`, `get_seo_optimization_advice`, `record_seo_change`, `get_seo_experiment_results`\n"
203
203
  " - **Client Reports**: `get_monthly_maintenance_summary`\n"
204
+ " - **Page Analytics & Conversion Insights**: `get_page_analytics`\n"
204
205
  "- **Agent Instructions**:\n"
205
206
  " 1. Error Triage: Query `list_errors` to inspect open issues. Use `get_error_journey` to see the exact user timeline before a crash. After fixing a bug in code and verifying, call `resolve_error(issue_id=...)`.\n"
206
207
  " 2. Performance: Query `get_performance_bottlenecks` to identify slow routes and N+1 queries. Optimize queries using `select_related()` / `prefetch_related()`.\n"
207
208
  " 3. SEO & Content: Query `get_keyword_opportunities` and `get_seo_optimization_advice`. When modifying titles/meta/content, call `record_seo_change(path=..., description=...)` so FetchNode can evaluate Search Console impact.\n"
208
209
  " 4. Reporting: Call `get_monthly_maintenance_summary` or trigger prompt `client_monthly_report` to generate a client-ready maintenance brief.\n"
210
+ " 5. Analytics & Funnels: Query `get_page_analytics` to analyze page engagement, bounce rates, high bounce landing pages (>= 50%), and conversion volume.\n"
209
211
  )
210
212
  updated = []
211
213
  found_any = False
@@ -375,6 +375,86 @@ def get_monthly_maintenance_summary(
375
375
  )
376
376
 
377
377
 
378
+ def get_page_analytics(
379
+ period_days: int = 7,
380
+ limit: int = 10,
381
+ include_bounce_pages: bool = True,
382
+ **kwargs,
383
+ ) -> dict[str, Any]:
384
+ """Retrieve website page analytics, bounce rates, high bounce pages, conversions, and key findings."""
385
+ return call_mcp_tool(
386
+ "get_page_analytics",
387
+ {
388
+ "period_days": period_days,
389
+ "limit": limit,
390
+ "include_bounce_pages": include_bounce_pages,
391
+ },
392
+ **kwargs,
393
+ )
394
+
395
+
396
+ def get_pagespeed_opportunities(
397
+ path: str | None = None,
398
+ strategy: str = "mobile",
399
+ refresh: bool = False,
400
+ **kwargs,
401
+ ) -> dict[str, Any]:
402
+ """Audit Core Web Vitals, speed bottlenecks, and technical on-page SEO issues."""
403
+ return call_mcp_tool(
404
+ "get_pagespeed_opportunities",
405
+ {"path": path, "strategy": strategy, "refresh": refresh},
406
+ **kwargs,
407
+ )
408
+
409
+
410
+ def get_keyword_search_volume(
411
+ queries: list[str],
412
+ country: str = "",
413
+ language: str = "",
414
+ **kwargs,
415
+ ) -> dict[str, Any]:
416
+ """Retrieve monthly Google search volume and competition metrics via Keyword Planner."""
417
+ payload: dict[str, Any] = {"queries": queries}
418
+ if country:
419
+ payload["country"] = country
420
+ if language:
421
+ payload["language"] = language
422
+ return call_mcp_tool("get_keyword_search_volume", payload, **kwargs)
423
+
424
+
425
+ def discover_keyword_ideas(
426
+ seed_keywords: list[str] | None = None,
427
+ page_url: str | None = None,
428
+ country: str = "",
429
+ language: str = "",
430
+ limit: int = 20,
431
+ **kwargs,
432
+ ) -> dict[str, Any]:
433
+ """Generate related keyword ideas and Google search volumes via Keyword Planner."""
434
+ payload: dict[str, Any] = {"limit": limit}
435
+ if seed_keywords:
436
+ payload["seed_keywords"] = seed_keywords
437
+ if page_url:
438
+ payload["page_url"] = page_url
439
+ if country:
440
+ payload["country"] = country
441
+ if language:
442
+ payload["language"] = language
443
+ return call_mcp_tool("discover_keyword_ideas", payload, **kwargs)
444
+
445
+
446
+ def get_google_search_suggestions(
447
+ query: str,
448
+ language: str = "",
449
+ **kwargs,
450
+ ) -> dict[str, Any]:
451
+ """Fetch real-time Google Autocomplete search intent expansions."""
452
+ payload: dict[str, Any] = {"query": query}
453
+ if language:
454
+ payload["language"] = language
455
+ return call_mcp_tool("get_google_search_suggestions", payload, **kwargs)
456
+
457
+
378
458
  def get_mcp_tools(**kwargs) -> list[dict[str, Any]]:
379
459
  """List available MCP tool definitions."""
380
460
  resp = send_mcp_request({"jsonrpc": "2.0", "id": 1, "method": "tools/list"}, **kwargs)
@@ -1,3 +1,3 @@
1
1
  """FetchNode Python SDK version shared by package metadata and telemetry."""
2
2
 
3
- SDK_VERSION = "0.6.0"
3
+ SDK_VERSION = "0.6.2"
@@ -201,11 +201,13 @@ class Command(BaseCommand):
201
201
  " - **Speed & Bottlenecks**: `get_performance_bottlenecks`\n"
202
202
  " - **SEO & Search Console**: `get_seo_overview`, `get_keyword_opportunities`, `get_page_performance`, `get_declining_pages`, `get_technical_seo_health`, `get_seo_optimization_advice`, `record_seo_change`, `get_seo_experiment_results`\n"
203
203
  " - **Client Reports**: `get_monthly_maintenance_summary`\n"
204
+ " - **Page Analytics & Conversion Insights**: `get_page_analytics`\n"
204
205
  "- **Agent Instructions**:\n"
205
206
  " 1. Error Triage: Query `list_errors` to inspect open issues. Use `get_error_journey` to see the exact user timeline before a crash. After fixing a bug in code and verifying, call `resolve_error(issue_id=...)`.\n"
206
207
  " 2. Performance: Query `get_performance_bottlenecks` to identify slow routes and N+1 queries. Optimize queries using `select_related()` / `prefetch_related()`.\n"
207
208
  " 3. SEO & Content: Query `get_keyword_opportunities` and `get_seo_optimization_advice`. When modifying titles/meta/content, call `record_seo_change(path=..., description=...)` so FetchNode can evaluate Search Console impact.\n"
208
209
  " 4. Reporting: Call `get_monthly_maintenance_summary` or trigger prompt `client_monthly_report` to generate a client-ready maintenance brief.\n"
210
+ " 5. Analytics & Funnels: Query `get_page_analytics` to analyze page engagement, bounce rates, high bounce landing pages (>= 50%), and conversion volume.\n"
209
211
  )
210
212
  updated = []
211
213
  found_any = False
@@ -375,6 +375,86 @@ def get_monthly_maintenance_summary(
375
375
  )
376
376
 
377
377
 
378
+ def get_page_analytics(
379
+ period_days: int = 7,
380
+ limit: int = 10,
381
+ include_bounce_pages: bool = True,
382
+ **kwargs,
383
+ ) -> dict[str, Any]:
384
+ """Retrieve website page analytics, bounce rates, high bounce pages, conversions, and key findings."""
385
+ return call_mcp_tool(
386
+ "get_page_analytics",
387
+ {
388
+ "period_days": period_days,
389
+ "limit": limit,
390
+ "include_bounce_pages": include_bounce_pages,
391
+ },
392
+ **kwargs,
393
+ )
394
+
395
+
396
+ def get_pagespeed_opportunities(
397
+ path: str | None = None,
398
+ strategy: str = "mobile",
399
+ refresh: bool = False,
400
+ **kwargs,
401
+ ) -> dict[str, Any]:
402
+ """Audit Core Web Vitals, speed bottlenecks, and technical on-page SEO issues."""
403
+ return call_mcp_tool(
404
+ "get_pagespeed_opportunities",
405
+ {"path": path, "strategy": strategy, "refresh": refresh},
406
+ **kwargs,
407
+ )
408
+
409
+
410
+ def get_keyword_search_volume(
411
+ queries: list[str],
412
+ country: str = "",
413
+ language: str = "",
414
+ **kwargs,
415
+ ) -> dict[str, Any]:
416
+ """Retrieve monthly Google search volume and competition metrics via Keyword Planner."""
417
+ payload: dict[str, Any] = {"queries": queries}
418
+ if country:
419
+ payload["country"] = country
420
+ if language:
421
+ payload["language"] = language
422
+ return call_mcp_tool("get_keyword_search_volume", payload, **kwargs)
423
+
424
+
425
+ def discover_keyword_ideas(
426
+ seed_keywords: list[str] | None = None,
427
+ page_url: str | None = None,
428
+ country: str = "",
429
+ language: str = "",
430
+ limit: int = 20,
431
+ **kwargs,
432
+ ) -> dict[str, Any]:
433
+ """Generate related keyword ideas and Google search volumes via Keyword Planner."""
434
+ payload: dict[str, Any] = {"limit": limit}
435
+ if seed_keywords:
436
+ payload["seed_keywords"] = seed_keywords
437
+ if page_url:
438
+ payload["page_url"] = page_url
439
+ if country:
440
+ payload["country"] = country
441
+ if language:
442
+ payload["language"] = language
443
+ return call_mcp_tool("discover_keyword_ideas", payload, **kwargs)
444
+
445
+
446
+ def get_google_search_suggestions(
447
+ query: str,
448
+ language: str = "",
449
+ **kwargs,
450
+ ) -> dict[str, Any]:
451
+ """Fetch real-time Google Autocomplete search intent expansions."""
452
+ payload: dict[str, Any] = {"query": query}
453
+ if language:
454
+ payload["language"] = language
455
+ return call_mcp_tool("get_google_search_suggestions", payload, **kwargs)
456
+
457
+
378
458
  def get_mcp_tools(**kwargs) -> list[dict[str, Any]]:
379
459
  """List available MCP tool definitions."""
380
460
  resp = send_mcp_request({"jsonrpc": "2.0", "id": 1, "method": "tools/list"}, **kwargs)
File without changes
File without changes