fetchnode 0.6.2__tar.gz → 0.7.0__tar.gz

{fetchnode-0.6.2 → fetchnode-0.7.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # FetchNode SDK changelog
 
+## 0.7.0 — 2026-11-13
+
+### Added
+
+- Opt-in remote terminal agent. It starts only when `FETCHNODE_TERMINAL=true` is set on the server. The private key stays on that server. `actions` mode runs predefined checks; `shell` mode is a separate local setting and refuses to run as root.
+- New dependency: `cryptography`, used for the terminal agent's local Ed25519 key.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.7.0
+```
+
 ## 0.6.2 — 2026-10-27
 
 ### Added

{fetchnode-0.6.2 → fetchnode-0.7.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: fetchnode
-Version: 0.6.2
+Version: 0.7.0
 Summary: Official Django and Python client SDK for FetchNode monitoring
 Project-URL: Homepage, https://fetch-node.com
 Project-URL: Documentation, https://fetch-node.com/guide/
 Project-URL: Repository, https://github.com/remcovanwijk040/fetchnode
 Project-URL: Issues, https://github.com/remcovanwijk040/fetchnode/issues
-Project-URL: Changelog, https://pypi.org/project/fetchnode/0.6.1/#sdk-changelog
+Project-URL: Changelog, https://pypi.org/project/fetchnode/0.7.0/#sdk-changelog
 Author-email: Remco van Wijk <remcovanwijk040@users.noreply.github.com>
 License-Expression: MIT
 License-File: LICENSE
@@ -30,6 +30,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Monitoring
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
+Requires-Dist: cryptography>=42
 Requires-Dist: django>=4.2
 Provides-Extra: celery
 Requires-Dist: celery>=5.0; extra == 'celery'
@@ -61,6 +62,7 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
   - [Celery Job Monitoring](#celery-job-monitoring)
   - [Logging Handler](#logging-handler)
 - [Model Context Protocol (MCP) for AI Agents](#model-context-protocol-mcp-for-ai-agents)
+- [Remote terminal](#remote-terminal)
 - [Privacy & Security Defaults](#privacy--security-defaults)
 
 - [Testing in Development](#testing-in-development)
@@ -72,7 +74,7 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
 
 ## Installation
 
-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.
+Version 0.7.0 adds an opt-in remote terminal. It starts only when `FETCHNODE_TERMINAL=true` is set on the server, and the package depends on `cryptography` for the local key.
 See the [SDK changelog](#sdk-changelog) for changes and upgrade instructions.
 
 Install via `pip`:
@@ -254,6 +256,7 @@ This single command configures your editor agent and automatically documents the
 
 * **`get_seo_overview`**: Organic clicks, search views, CTR, average position, and period changes.
 * **`get_keyword_opportunities`**: High-potential striking-distance queries (positions 4–20), low-CTR terms, and zero-click keywords.
+* **`get_question_queries`**: Question queries the site already ranks for, with landing pages. Highlights high-impression, low-CTR questions in positions 5–20 as FAQ or H2 candidates. English question words by default; Dutch sites also include Dutch question words.
 * **`get_page_performance`**: Landing page traffic, conversions, conversion rate, and driving queries.
 * **`get_declining_pages`**: Landing pages and search queries losing organic Google clicks.
 * **`get_technical_seo_health`**: Open 500 server errors and 404s affecting landing paths.
@@ -271,6 +274,14 @@ opportunities = get_keyword_opportunities(category="striking_distance")
 
 ---
 
+## Remote terminal
+
+The package can open an outbound terminal to the FetchNode dashboard. It stays off until the server sets `FETCHNODE_TERMINAL=true`. FetchNode cannot turn it on. `FETCHNODE_TERMINAL_MODE` is `actions` (the default) or `shell`. The shell runs as the current non-root user and refuses to change user. The private key stays on the server.
+
+Restart and log tail do nothing useful until `FETCHNODE_TERMINAL_RESTART_COMMAND` and `FETCHNODE_TERMINAL_LOG_PATH` are set locally. Set `FETCHNODE_TERMINAL_AUTOSTART=0` and run `python manage.py fetchnode_terminal` when the agent should be a separate process.
+
+---
+
 ## Privacy & Security Defaults
 
 
@@ -278,7 +289,7 @@ FetchNode is engineered with a strict **privacy-first architecture**:
 1. **Client-side Scrubbing:** Sensitive keys (`password`, `token`, `secret`, `api_key`, `authorization`, `cookie`, `csrfmiddlewaretoken`) and any compound keys like `user_password` or `client_secret` are scrubbed before payload transmission.
 2. **Safe SQL Normalization:** Raw SQL text is stripped of literals and parameters (`SELECT * FROM user WHERE id = 123` becomes `SELECT * FROM user WHERE id = ?`).
 3. **No Unintentional PII:** Request bodies, query strings, and raw IP addresses are excluded by default.
-4. **Inspectable & Lightweight:** The entire client is open-source Python with zero compiled binaries and zero unnecessary dependencies.
+4. **Inspectable:** The client is open-source Python. The opt-in terminal uses the `cryptography` package for its local key and does not add a separate agent install.
 
 ---
 
@@ -328,6 +339,34 @@ MIT License. See [LICENSE](LICENSE) for details.
 
 # SDK changelog
 
+## 0.7.0 — 2026-11-13
+
+### Added
+
+- Opt-in remote terminal agent. It starts only when `FETCHNODE_TERMINAL=true` is set on the server. The private key stays on that server. `actions` mode runs predefined checks; `shell` mode is a separate local setting and refuses to run as root.
+- New dependency: `cryptography`, used for the terminal agent's local Ed25519 key.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.7.0
+```
+
+## 0.6.2 — 2026-10-27
+
+### Added
+
+- 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).
+- Google Autocomplete search intent expansions: `get_google_search_suggestions` retrieves real-time user query suggestions directly from Google.
+- Core Web Vitals & Technical SEO audits: `get_pagespeed_opportunities` audits page speed, performance bottlenecks, and technical on-page SEO issues.
+- Target market auto-inference: tools automatically resolve the target country and language from project telemetry, domain TLD, and configured market focus.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.6.2
+```
+
 ## 0.6.1 — 2026-10-22
 
 ### Added

{fetchnode-0.6.2 → fetchnode-0.7.0}/README.md

@@ -24,6 +24,7 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
   - [Celery Job Monitoring](#celery-job-monitoring)
   - [Logging Handler](#logging-handler)
 - [Model Context Protocol (MCP) for AI Agents](#model-context-protocol-mcp-for-ai-agents)
+- [Remote terminal](#remote-terminal)
 - [Privacy & Security Defaults](#privacy--security-defaults)
 
 - [Testing in Development](#testing-in-development)
@@ -35,7 +36,7 @@ FetchNode captures unhandled exceptions, error logs, slow database queries, N+1
 
 ## Installation
 
-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.
+Version 0.7.0 adds an opt-in remote terminal. It starts only when `FETCHNODE_TERMINAL=true` is set on the server, and the package depends on `cryptography` for the local key.
 See the [SDK changelog](#sdk-changelog) for changes and upgrade instructions.
 
 Install via `pip`:
@@ -217,6 +218,7 @@ This single command configures your editor agent and automatically documents the
 
 * **`get_seo_overview`**: Organic clicks, search views, CTR, average position, and period changes.
 * **`get_keyword_opportunities`**: High-potential striking-distance queries (positions 4–20), low-CTR terms, and zero-click keywords.
+* **`get_question_queries`**: Question queries the site already ranks for, with landing pages. Highlights high-impression, low-CTR questions in positions 5–20 as FAQ or H2 candidates. English question words by default; Dutch sites also include Dutch question words.
 * **`get_page_performance`**: Landing page traffic, conversions, conversion rate, and driving queries.
 * **`get_declining_pages`**: Landing pages and search queries losing organic Google clicks.
 * **`get_technical_seo_health`**: Open 500 server errors and 404s affecting landing paths.
@@ -234,6 +236,14 @@ opportunities = get_keyword_opportunities(category="striking_distance")
 
 ---
 
+## Remote terminal
+
+The package can open an outbound terminal to the FetchNode dashboard. It stays off until the server sets `FETCHNODE_TERMINAL=true`. FetchNode cannot turn it on. `FETCHNODE_TERMINAL_MODE` is `actions` (the default) or `shell`. The shell runs as the current non-root user and refuses to change user. The private key stays on the server.
+
+Restart and log tail do nothing useful until `FETCHNODE_TERMINAL_RESTART_COMMAND` and `FETCHNODE_TERMINAL_LOG_PATH` are set locally. Set `FETCHNODE_TERMINAL_AUTOSTART=0` and run `python manage.py fetchnode_terminal` when the agent should be a separate process.
+
+---
+
 ## Privacy & Security Defaults
 
 
@@ -241,7 +251,7 @@ FetchNode is engineered with a strict **privacy-first architecture**:
 1. **Client-side Scrubbing:** Sensitive keys (`password`, `token`, `secret`, `api_key`, `authorization`, `cookie`, `csrfmiddlewaretoken`) and any compound keys like `user_password` or `client_secret` are scrubbed before payload transmission.
 2. **Safe SQL Normalization:** Raw SQL text is stripped of literals and parameters (`SELECT * FROM user WHERE id = 123` becomes `SELECT * FROM user WHERE id = ?`).
 3. **No Unintentional PII:** Request bodies, query strings, and raw IP addresses are excluded by default.
-4. **Inspectable & Lightweight:** The entire client is open-source Python with zero compiled binaries and zero unnecessary dependencies.
+4. **Inspectable:** The client is open-source Python. The opt-in terminal uses the `cryptography` package for its local key and does not add a separate agent install.
 
 ---
 
@@ -291,6 +301,34 @@ MIT License. See [LICENSE](LICENSE) for details.
 
 # SDK changelog
 
+## 0.7.0 — 2026-11-13
+
+### Added
+
+- Opt-in remote terminal agent. It starts only when `FETCHNODE_TERMINAL=true` is set on the server. The private key stays on that server. `actions` mode runs predefined checks; `shell` mode is a separate local setting and refuses to run as root.
+- New dependency: `cryptography`, used for the terminal agent's local Ed25519 key.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.7.0
+```
+
+## 0.6.2 — 2026-10-27
+
+### Added
+
+- 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).
+- Google Autocomplete search intent expansions: `get_google_search_suggestions` retrieves real-time user query suggestions directly from Google.
+- Core Web Vitals & Technical SEO audits: `get_pagespeed_opportunities` audits page speed, performance bottlenecks, and technical on-page SEO issues.
+- Target market auto-inference: tools automatically resolve the target country and language from project telemetry, domain TLD, and configured market focus.
+
+### Upgrade
+
+```bash
+python -m pip install --upgrade fetchnode==0.6.2
+```
+
 ## 0.6.1 — 2026-10-22
 
 ### Added

{fetchnode-0.6.2 → fetchnode-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fetchnode"
-version = "0.6.2"
+version = "0.7.0"
 description = "Official Django and Python client SDK for FetchNode monitoring"
 readme = "README.md"
 license = "MIT"
@@ -34,6 +34,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
+    "cryptography>=42",
     "django>=4.2",
 ]
 
@@ -47,7 +48,7 @@ Homepage = "https://fetch-node.com"
 Documentation = "https://fetch-node.com/guide/"
 Repository = "https://github.com/remcovanwijk040/fetchnode"
 Issues = "https://github.com/remcovanwijk040/fetchnode/issues"
-Changelog = "https://pypi.org/project/fetchnode/0.6.1/#sdk-changelog"
+Changelog = "https://pypi.org/project/fetchnode/0.7.0/#sdk-changelog"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/fetchnode", "src/fetchnode_client"]

{fetchnode-0.6.2 → fetchnode-0.7.0}/src/fetchnode/apps.py

@@ -33,6 +33,16 @@ class FetchNodeConfig(AppConfig):
             from fetchnode.excepthook import install_excepthook_instrumentation
             install_excepthook_instrumentation()
 
+        try:
+            from fetchnode.terminal import maybe_autostart
+            maybe_autostart()
+        except Exception:
+            import logging
+            logging.getLogger("fetchnode.terminal").warning(
+                "FetchNode terminal agent was not started.",
+                exc_info=True,
+            )
+
 
 def __getattr__(name):
     # Keep explicit legacy imports working without exposing a second AppConfig

{fetchnode-0.6.2 → fetchnode-0.7.0}/src/fetchnode/management/commands/fetchnode_mcp.py

@@ -199,13 +199,13 @@ class Command(BaseCommand):
             "- **Available Tools**:\n"
             "  - **Errors & User Journeys**: `list_errors`, `get_error_details`, `get_error_journey`, `resolve_error`, `ignore_error`\n"
             "  - **Speed & Bottlenecks**: `get_performance_bottlenecks`\n"
-            "  - **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"
+            "  - **SEO & Search Console**: `get_seo_overview`, `get_keyword_opportunities`, `get_question_queries`, `get_page_performance`, `get_declining_pages`, `get_technical_seo_health`, `get_seo_optimization_advice`, `record_seo_change`, `get_seo_experiment_results`\n"
             "  - **Client Reports**: `get_monthly_maintenance_summary`\n"
             "  - **Page Analytics & Conversion Insights**: `get_page_analytics`\n"
             "- **Agent Instructions**:\n"
             "  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"
             "  2. Performance: Query `get_performance_bottlenecks` to identify slow routes and N+1 queries. Optimize queries using `select_related()` / `prefetch_related()`.\n"
-            "  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"
+            "  3. SEO & Content: Query `get_keyword_opportunities`, `get_question_queries`, and `get_seo_optimization_advice`. Use `get_question_queries` for questions the site already ranks for that should become an FAQ entry or H2. When modifying titles/meta/content, call `record_seo_change(path=..., description=...)` so FetchNode can evaluate Search Console impact.\n"
             "  4. Reporting: Call `get_monthly_maintenance_summary` or trigger prompt `client_monthly_report` to generate a client-ready maintenance brief.\n"
             "  5. Analytics & Funnels: Query `get_page_analytics` to analyze page engagement, bounce rates, high bounce landing pages (>= 50%), and conversion volume.\n"
         )

fetchnode-0.7.0/src/fetchnode/management/commands/fetchnode_terminal.py

@@ -0,0 +1,15 @@
+"""Run the opt-in FetchNode terminal agent in the foreground."""
+
+from django.core.management.base import BaseCommand
+
+from fetchnode.terminal import run_agent_forever, terminal_settings
+
+
+class Command(BaseCommand):
+    help = "Keep an outbound terminal connection open when FETCHNODE_TERMINAL is enabled locally."
+
+    def handle(self, *args, **options):
+        if not terminal_settings()["enabled"]:
+            self.stderr.write("FETCHNODE_TERMINAL is off. The agent will not start, and FetchNode cannot turn it on.")
+            return
+        run_agent_forever()

{fetchnode-0.6.2 → fetchnode-0.7.0}/src/fetchnode/mcp.py

@@ -190,6 +190,24 @@ def get_keyword_opportunities(
     )
 
 
+def get_question_queries(
+    limit: int = 15,
+    period_days: int = 28,
+    language: str = "",
+    opportunities_only: bool = False,
+    **kwargs,
+) -> dict[str, Any]:
+    """List question queries this site already ranks for, ranked as FAQ or H2 opportunities."""
+    arguments: dict[str, Any] = {
+        "limit": limit,
+        "period_days": period_days,
+        "opportunities_only": opportunities_only,
+    }
+    if language:
+        arguments["language"] = language
+    return call_mcp_tool("get_question_queries", arguments, **kwargs)
+
+
 def get_page_performance(
     path: str = "", limit: int = 10, period_days: int = 28, **kwargs
 ) -> dict[str, Any]: