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.
- {fetchnode-0.6.0 → fetchnode-0.6.2}/CHANGELOG.md +30 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/PKG-INFO +18 -3
- {fetchnode-0.6.0 → fetchnode-0.6.2}/README.md +16 -1
- {fetchnode-0.6.0 → fetchnode-0.6.2}/pyproject.toml +2 -2
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/management/commands/fetchnode_mcp.py +2 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/mcp.py +80 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/version.py +1 -1
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/commands/fetchnode_mcp.py +2 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/mcp.py +80 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/.gitignore +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/LICENSE +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/__init__.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/api.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/apps.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/capture.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/celery.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/conf.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/demo.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/excepthook.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/handlers.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/management/__init__.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/management/commands/__init__.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/middleware.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/py.typed +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/query.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/scope.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/scrub.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/sender.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode/utils.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/__init__.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/api.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/apps.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/capture.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/celery.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/conf.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/demo.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/excepthook.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/handlers.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/__init__.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/commands/__init__.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/middleware.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/py.typed +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/query.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/scope.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/scrub.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/sender.py +0 -0
- {fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/utils.py +0 -0
- {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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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)
|
{fetchnode-0.6.0 → fetchnode-0.6.2}/src/fetchnode_client/management/commands/fetchnode_mcp.py
RENAMED
|
@@ -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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|