diff --git a/surfsense_backend/app/capabilities/web/crawl/schemas.py b/surfsense_backend/app/capabilities/web/crawl/schemas.py
index 38ab0e7f5..6b7b627eb 100644
--- a/surfsense_backend/app/capabilities/web/crawl/schemas.py
+++ b/surfsense_backend/app/capabilities/web/crawl/schemas.py
@@ -1,13 +1,12 @@
-# ruff: noqa: N815 - public field names intentionally mirror the Apify camelCase spec
+# ruff: noqa: N815 - public field names intentionally use camelCase
 """``web.crawl`` I/O contracts.
 
-An Apify *Website Content Crawler*-style surface (see apify.com/apify/website-
-content-crawler and docs.firecrawl.dev): one verb that either scrapes the given
+A Website Content Crawler-style surface: one verb that either scrapes the given
 URLs (``maxCrawlDepth == 0``) or spiders their site (``maxCrawlDepth > 0``),
 bounded by ``maxCrawlPages`` and kept on the seed's site.
 
-Fields are trimmed to what the proprietary engine honors today. Apify knobs the
-engine handles automatically (crawler type, proxy, dynamic-render waits) are
+Fields are trimmed to what the proprietary engine honors today. Knobs the engine
+handles automatically (crawler type, proxy, dynamic-render waits) are
 intentionally omitted, as are features we haven't built (URL globs, output
 formats, click actions, PII handling).
 """
diff --git a/surfsense_backend/app/capabilities/youtube/comments/executor.py b/surfsense_backend/app/capabilities/youtube/comments/executor.py
index a5f4338c9..ceeb2bde3 100644
--- a/surfsense_backend/app/capabilities/youtube/comments/executor.py
+++ b/surfsense_backend/app/capabilities/youtube/comments/executor.py
@@ -1,4 +1,4 @@
-"""``youtube.comments`` executor: verb input → Apify actor → comment items."""
+"""``youtube.comments`` executor: verb input → scraper → comment items."""
 
 from __future__ import annotations
 
diff --git a/surfsense_backend/app/capabilities/youtube/comments/schemas.py b/surfsense_backend/app/capabilities/youtube/comments/schemas.py
index 62eb7c451..e72181a32 100644
--- a/surfsense_backend/app/capabilities/youtube/comments/schemas.py
+++ b/surfsense_backend/app/capabilities/youtube/comments/schemas.py
@@ -1,7 +1,7 @@
 """``youtube.comments`` I/O contracts.
 
-A lean surface over the Apify-compatible ``YouTubeCommentsInput``; the actor's
-``CommentItem`` is reused verbatim as the output element for parity.
+A lean surface over ``YouTubeCommentsInput``; the scraper's ``CommentItem`` is
+reused verbatim as the output element.
 """
 
 from __future__ import annotations
diff --git a/surfsense_backend/app/capabilities/youtube/scrape/executor.py b/surfsense_backend/app/capabilities/youtube/scrape/executor.py
index 46d4789dc..17047be90 100644
--- a/surfsense_backend/app/capabilities/youtube/scrape/executor.py
+++ b/surfsense_backend/app/capabilities/youtube/scrape/executor.py
@@ -1,4 +1,4 @@
-"""``youtube.scrape`` executor: verb input → Apify actor → video items."""
+"""``youtube.scrape`` executor: verb input → scraper → video items."""
 
 from __future__ import annotations
 
diff --git a/surfsense_backend/app/capabilities/youtube/scrape/schemas.py b/surfsense_backend/app/capabilities/youtube/scrape/schemas.py
index f24e19828..8947f601f 100644
--- a/surfsense_backend/app/capabilities/youtube/scrape/schemas.py
+++ b/surfsense_backend/app/capabilities/youtube/scrape/schemas.py
@@ -1,9 +1,9 @@
 """``youtube.scrape`` I/O contracts.
 
-A lean, agent-friendly surface over the Apify-compatible ``YouTubeScrapeInput``
-(``app/proprietary/platforms/youtube``). The executor maps this to the full actor
-input; the actor's ``VideoItem`` is reused verbatim as the output element so the
-verb stays parity-faithful with the underlying Apify shape.
+A lean, agent-friendly surface over ``YouTubeScrapeInput``
+(``app/proprietary/platforms/youtube``). The executor maps this to the full
+scraper input; the scraper's ``VideoItem`` is reused verbatim as the output
+element.
 """
 
 from __future__ import annotations