33 lines
1.3 KiB
Python
33 lines
1.3 KiB
Python
"""Stdlib fetch helper for simple url_pattern brokers (osint-style).
|
|
|
|
For JS-rendered or anti-bot pages the agent should use the `web_extract` or
|
|
`browser_navigate` tools (and the `scrapling` skill for stealth/Cloudflare).
|
|
This helper only covers plain static pages and is intentionally network-light so
|
|
it can be mocked in tests.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import urllib.error
|
|
import urllib.request
|
|
|
|
USER_AGENT = "Mozilla/5.0 (compatible; unbroker/1.0; data opt-out)"
|
|
|
|
|
|
def fetch(url: str, timeout: int = 20) -> tuple[int, str]:
|
|
req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})
|
|
try:
|
|
with urllib.request.urlopen(req, timeout=timeout) as resp: # noqa: S310 (https only by convention)
|
|
charset = resp.headers.get_content_charset() or "utf-8"
|
|
return getattr(resp, "status", 200), resp.read().decode(charset, errors="replace")
|
|
except urllib.error.HTTPError as exc:
|
|
return exc.code, ""
|
|
except (urllib.error.URLError, TimeoutError, ValueError):
|
|
return 0, ""
|
|
|
|
|
|
def looks_listed(html: str, match_signal: str | None) -> bool:
|
|
"""Naive confirmation heuristic for static pages: does the match signal appear?"""
|
|
if not html or not match_signal:
|
|
return False
|
|
return match_signal.lower() in html.lower()
|