pi-chrome-search 2.0.0 → 2.1.0

package/README.md

@@ -1,8 +1,16 @@
 # pi-chrome-search
 
+[![npm](https://img.shields.io/npm/v/pi-chrome-search)](https://www.npmjs.com/package/pi-chrome-search)
+[![downloads](https://img.shields.io/npm/dm/pi-chrome-search)](https://www.npmjs.com/package/pi-chrome-search)
+[![pi](https://img.shields.io/badge/pi-package-6f42c1)](https://pi.dev/packages)
+[![ci](https://github.com/sh2nk/pi-chrome-search/actions/workflows/ci.yml/badge.svg)](https://github.com/sh2nk/pi-chrome-search/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/pi-chrome-search)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D26-brightgreen)](package.json)
+
 Web search and page reading for [pi](https://pi.dev), through your own visible Chrome. Same profile,
 cookies and IP. Google, DuckDuckGo and Yandex return compact Markdown and their native AI summary when
-there is one. No keys, no paid APIs, no headless mode, no fingerprint spoofing. Node 26+, Chrome 136+.
+there is one; Avito listings (price, location, age) are available opt-in. No keys, no paid APIs, no
+headless mode, no fingerprint spoofing. Node 26+, Chrome 136+.
 
 ## Install
 
@@ -24,7 +32,7 @@ The window stays visible. The extension attaches to it and never launches, resta
 <!-- tools:start -->
 | Tool | Exposure | Arguments |
 |---|---|---|
-| `web_search` | direct | `q` string; `n?` integer 1..10; `engines?` "auto" or ("google" or "duckduckgo" or "yandex") or list of ("google" or "duckduckgo" or "yandex") 1..3; `summary?` boolean; `page?` integer >=1; `format?` "md" or "json" |
+| `web_search` | direct | `q` string; `n?` integer 1..10; `engines?` "auto" or ("google" or "duckduckgo" or "yandex" or "avito") or list of ("google" or "duckduckgo" or "yandex" or "avito") 1..4; `summary?` boolean; `page?` integer >=1; `format?` "md" or "json" |
 | `web_read` | direct | `url` string; `offset?` integer >=0; `maxChars?` integer >=1; `format?` "md" or "text" |
 | `image_search` | deferred | `q` string; `n?` integer 1..12; `engine?` "google" or "yandex"; `attach?` boolean or "bytes" |
 | `web_research` | deferred | `q` string; `budget?` "quick" or "normal" or "deep" |
@@ -32,7 +40,14 @@ The window stays visible. The extension attaches to it and never launches, resta
 <!-- tools:end -->
 
 A call has one 60 second deadline. DuckDuckGo has no pagination: `page > 1` is reported as
-`ignored.page`. Every unresolved link stays marked `unresolved`.
+`ignored.page`; Avito has no AI block: `summary` is reported as `ignored.summary`. Every unresolved
+link stays marked `unresolved`, and card facts (price/availability/rating/location) render on their
+own line after the snippet.
+
+`engines: "auto"` only ever means Google → DuckDuckGo → Yandex. Avito is a *special* engine: it is off
+by default and reachable only by naming it. To turn it on, set `engines.avito.enabled` to `true` (and
+optionally `engines.avito.location`, a region slug such as `kaluga` or `all`) in
+`~/.pi/agent/web-search.json` — ask your agent to do it, that is the intended path.
 
 ## Limits
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-chrome-search",
-  "version": "2.0.0",
-  "description": "Free, keyless web search through the user's own visible Chrome (Google, DuckDuckGo, Yandex) for pi",
+  "version": "2.1.0",
+  "description": "Free, keyless web search through the user's own visible Chrome (Google, DuckDuckGo, Yandex, and opt-in Avito listings) for pi",
   "type": "module",
   "license": "MIT",
   "pi": {
@@ -45,7 +45,8 @@
     "web-search",
     "google",
     "duckduckgo",
-    "yandex"
+    "yandex",
+    "avito"
   ],
   "files": [
     "index.ts",

package/src/config/defaults.ts

@@ -48,10 +48,26 @@ export interface YandexConfig {
   lr: string;
 }
 
+export interface AvitoConfig {
+  /**
+   * OFF by default (SPEC §15 D12): Avito is a *special* engine, so a fresh
+   * install must not touch its anti-bot machinery. Enabling it is one key in
+   * `web-search.json`; the disabled-engine hint names the file.
+   */
+  enabled: boolean;
+  /**
+   * Region path slug in the Avito URL (`all`, `moskva`, `kaluga`), not a display
+   * name. `all` = every region; Avito itself falls back to nearby regions with
+   * delivery when the item is not sold locally.
+   */
+  location: string;
+}
+
 export interface EnginesConfig {
   google: GoogleConfig;
   duckduckgo: DuckDuckGoConfig;
   yandex: YandexConfig;
+  avito: AvitoConfig;
 }
 
 export type PacingWindow = [number, number];
@@ -60,6 +76,8 @@ export interface PacingConfig {
   google: PacingWindow;
   duckduckgo: PacingWindow;
   yandex: PacingWindow;
+  /** Slowest window: Avito is the most aggressive of the four about automation. */
+  avito: PacingWindow;
 }
 
 export interface SearchConfig {
@@ -130,8 +148,9 @@ export const DEFAULT_CONFIG: Config = {
     google: { enabled: true, lang: "auto", gl: "auto" },
     duckduckgo: { enabled: true, kl: "auto" },
     yandex: { enabled: true, lr: "auto" },
+    avito: { enabled: false, location: "all" },
   },
-  pacing: { google: [2500, 5000], yandex: [5000, 9000], duckduckgo: [2000, 4000] },
+  pacing: { google: [2500, 5000], yandex: [5000, 9000], duckduckgo: [2000, 4000], avito: [6000, 12000] },
   search: {
     budgetMs: 60000,
     n: 5,

package/src/config/doc.ts

@@ -28,9 +28,12 @@ const CONFIG_DOCS: Readonly<Record<string, string>> = {
   "engines.duckduckgo.kl": "Region/language; `auto` omits it.",
   "engines.yandex.enabled": "Use Yandex.",
   "engines.yandex.lr": "`lr`; `auto` omits it.",
+  "engines.avito.enabled": "Use the Avito marketplace engine (special: only an explicit `engines: \"avito\"` reaches it, `auto` never does). Off by default.",
+  "engines.avito.location": "Region path slug in the Avito URL (`all`, `moskva`, `kaluga`), not a display name.",
   "pacing.google": "Min/max gap in ms between Google searches.",
   "pacing.duckduckgo": "Min/max gap in ms between DuckDuckGo searches.",
   "pacing.yandex": "Min/max gap in ms between Yandex searches.",
+  "pacing.avito": "Min/max gap in ms between Avito searches.",
   "search.budgetMs": "Whole-call deadline in ms; pacing, settle, AI wait and link resolution draw from it (S8.1).",
   "search.n": "Default result count.",
   "search.nMax": "Hard ceiling for `n`; never above 10.",

package/src/config/schema.ts

@@ -54,6 +54,7 @@ export const CONFIG_SPEC: Spec = {
         google: { kind: "object", fields: { enabled: BOOL, lang: STRING_NE, gl: STRING_NE } },
         duckduckgo: { kind: "object", fields: { enabled: BOOL, kl: STRING_NE } },
         yandex: { kind: "object", fields: { enabled: BOOL, lr: STRING_NE } },
+        avito: { kind: "object", fields: { enabled: BOOL, location: STRING_NE } },
       },
     },
     pacing: {
@@ -62,6 +63,7 @@ export const CONFIG_SPEC: Spec = {
         google: { kind: "tuple", items: [NUM(0), NUM(0)] },
         duckduckgo: { kind: "tuple", items: [NUM(0), NUM(0)] },
         yandex: { kind: "tuple", items: [NUM(0), NUM(0)] },
+        avito: { kind: "tuple", items: [NUM(0), NUM(0)] },
       },
     },
     search: {