--- name: qiaomu-opencli description: | Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion, Claude), or public APIs (HackerNews, arXiv, npm, pubmed). Also covers browser automation (navigate/click/type/extract), auto-fixing broken adapters, and creating new adapters for any website. Covers 136 site adapters, 7 app adapters, 13 external CLIs. version: 1.7.22 author: joeseesun upstream: jackwener/opencli tags: [opencli, cli, browser, web, chrome-extension, cdp, bilibili, twitter, reddit, xiaohongshu, github, youtube, AI, agent, automation] --- # OpenCLI — Complete Guide > Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery. --- ## Install & Run ```bash npm install -g @jackwener/opencli opencli npm update -g @jackwener/opencli # Update opencli --version # Check version ``` ## Prerequisites Browser commands require: 1. Chrome running **(logged into target sites)** 2. **opencli Browser Bridge** Chrome extension installed 3. Daemon auto-starts on first browser command ```bash opencli doctor # Diagnose extension + daemon connectivity ``` > Public API commands (`hackernews`, `arxiv`, `npm`, `pubmed`…) need no browser. --- ## Command Quick Reference Usage: `opencli [args] [--limit N] [-f json|yaml|md|csv|table]` Type legend: 🌐 = Browser (needs Chrome login) · ✅ = Public API · 🖥️ = Desktop (Electron/CDP) · 🔧 = External CLI ### Website Adapters (136 sites) | Site | Type | Commands | |------|------|----------| | **1688** | 🌐 | `search` `item` `download` `store` `assets` | | **1point3acres** | 🌐 | `hot` `latest` `digest` `search` `thread` `forum` `forums` `user` `notifications` | | **36kr** | 🌐 | `hot` `news` `search` `article` | | **51job** | 🌐 | `search` `hot` `detail` `company` | | **aibase** | 🌐 | `news` | | **amazon** | 🌐 | `bestsellers` `search` `product` `offer` `discussion` `movers-shakers` `new-releases` | | **apple-podcasts** | ✅ | `top` `search` `episodes` | | **arxiv** | ✅ | `search` `paper` `recent` `author` | | **baidu-scholar** | 🌐 | `search` | | **band** | 🌐 | `bands` `posts` `post` `mentions` | | **barchart** | 🌐 | `quote` `options` `greeks` `flow` | | **bbc** | ✅ | `news` `topic` | | **bilibili** | 🌐 | `hot` `search` `me` `favorite` `history` `feed` `feed-detail` `user-videos` `subtitle` `dynamic` `ranking` `following` `comments` `download` `video` | | **binance** | ✅ | `top` `ticker` `price` `klines` `gainers` `losers` `pairs` `trades` `depth` `asks` `prices` | | **bloomberg** | ✅🌐 | RSS: `main` `markets` `tech` `politics` `economics` `opinions` · Browser: `news` | | **bluesky** | 🌐 | `search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs` | | **boss** | 🌐 | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | | **brave** | 🌐 | `search` | | **chaoxing** | 🌐 | `assignments` `exams` | | **claude** | 🌐 | `status` `new` `send` `read` `ask` `detail` `history` | | **cnki** | 🌐 | `search` | | **coingecko** | ✅ | `top` `coin` `trending` `categories` `exchanges` `derivatives` `global` | | **coupang** | 🌐 | `search` `add-to-cart` | | **crates** | ✅ | `search` `crate` | | **ctrip** | 🌐 | `search` `hotel-search` `hotel-suggest` `flight` | | **dblp** | ✅ | `search` `author` `paper` `venue` | | **deepseek** | 🌐 | `status` `new` `send` `read` `ask` `detail` `history` | | **defillama** | ✅ | `protocols` `protocol` | | **devto** | ✅ | `top` `tag` `user` | | **dianping** | 🌐 | `search` `shop` | | **dictionary** | ✅ | `search` `synonyms` `examples` | | **dockerhub** | ✅ | `search` `image` | | **doubao** | 🌐 | `status` `new` `send` `read` `ask` `detail` `history` `meeting-summary` `meeting-transcript` | | **douban** | 🌐 | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` | | **douyin** | 🌐 | `profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update` | | **duckduckgo** | 🌐 | `search` `suggest` | | **eastmoney** | 🌐 | `quote` `kline` `hot-rank` `rank` `index-board` `sectors` `northbound` `money-flow` `kuaixun` `announcement` `etf` `convertible` `holders` `longhu` | | **endoflife** | ✅ | `product` | | **facebook** | 🌐 | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` `marketplace-inbox` `marketplace-listings` | | **flathub** | ✅ | `search` `app` | | **gemini** | 🌐 | `ask` `new` `image` `deep-research` `deep-research-result` | | **gitee** | 🌐 | `search` `trending` `user` | | **google** | ✅ | `news` `search` `suggest` `trends` | | **google-scholar** | 🌐 | `search` `profile` `cite` | | **goproxy** | ✅ | `module` `versions` | | **gov-law** | 🌐 | `search` `recent` | | **gov-policy** | 🌐 | `search` `recent` | | **grok** | 🌐 | `ask` | | **hackernews** | ✅ | `top` `new` `best` `ask` `show` `jobs` `search` `user` | | **hf** | ✅ | `top` | | **homebrew** | ✅ | `popular` `formula` `cask` | | **hupu** | 🌐 | `hot` `search` `detail` `like` `unlike` `reply` `mentions` | | **imdb** | ✅ | `top` `trending` `search` `title` `person` `reviews` | | **indeed** | 🌐 | `search` `job` | | **instagram** | 🌐 | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` `reel` `story` `post` `note` `download` `collection-create` `collection-delete` | | **jd** | 🌐 | `item` | | **jike** | 🌐 | `feed` `search` `create` `like` `comment` `repost` `notifications` `post` `topic` `user` | | **jimeng** | 🌐 | `generate` `history` | | **ke** | 🌐 | `ershoufang` `chengjiao` `xiaoqu` `zufang` | | **lesswrong** | ✅ | `frontpage` `curated` `new` `top` `top-week` `top-month` `top-year` `shortform` `read` `comments` `user` `user-posts` `sequences` `tags` `tag` | | **lichess** | ✅ | `top` `user` | | **linkedin** | 🌐 | `search` `timeline` | | **linux-do** | 🌐 | `hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `topic-content` `user-posts` `user-topics` | | **lobsters** | ✅ | `hot` `newest` `active` `tag` | | **maimai** | 🌐 | `search-talents` | | **maven** | ✅ | `search` `artifact` | | **mdn** | ✅ | `search` | | **medium** | 🌐 | `feed` `search` `user` | | **mubu** | 🌐 | `search` `recent` `doc` `docs` `notes` | | **notebooklm** | 🌐 | `status` `list` `open` `current` `get` `history` `summary` `note-list` `notes-get` `source-list` `source-get` `source-fulltext` `source-guide` | | **nowcoder** | 🌐 | `hot` `trending` `search` `suggest` `jobs` `companies` `experience` `salary` `practice` `papers` `topics` `creators` `detail` `notifications` `recommend` `referral` | | **npm** | ✅ | `search` `package` `downloads` | | **nuget** | ✅ | `search` `package` | | **nvd** | ✅ | `cve` | | **oeis** | ✅ | `search` `sequence` | | **ones** | 🌐 | `login` `logout` `me` `tasks` `task` `my-tasks` `worklog` `token-info` | | **openalex** | ✅ | `search` `work` | | **openfda** | ✅ | `drug-label` `food-recall` | | **openreview** | ✅ | `search` `paper` `author` `venue` `reviews` | | **osv** | ✅ | `vulnerability` `query` | | **packagist** | ✅ | `search` `package` | | **pixiv** | 🌐 | `ranking` `search` `user` `illusts` `detail` `download` | | **powerchina** | 🌐 | `search` | | **producthunt** | ✅ | `today` `hot` `browse` `posts` | | **pubmed** | ✅ | `search` `article` `author` `citations` `related` | | **pypi** | ✅ | `package` `downloads` | | **quark** | 🌐 | `ls` `mkdir` `mv` `rename` `rm` `save` `share-tree` | | **qwen** | 🌐 | `status` `new` `send` `read` `ask` `image` `detail` `history` | | **reddit** | 🌐 | `hot` `frontpage` `home` `popular` `search` `subreddit` `subreddit-info` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `reply` `subscribe` `saved` `upvoted` `whoami` | | **rednote** | 🌐 | `search` `feed` `user` `note` `comments` `download` `notifications` | | **rest-countries** | ✅ | `country` `region` | | **reuters** | 🌐 | `search` | | **rfc** | ✅ | `rfc` | | **rubygems** | ✅ | `search` `gem` | | **sinablog** | 🌐 | `hot` `search` `article` `user` | | **sinafinance** | ✅ | `news` | | **smzdm** | 🌐 | `search` | | **spotify** | ✅ | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` | | **stackoverflow** | ✅ | `hot` `search` `bounties` `unanswered` | | **steam** | ✅ | `top-sellers` | | **substack** | 🌐 | `feed` `search` `publication` | | **taobao** | 🌐 | `search` `detail` `reviews` `add-cart` `cart` | | **tdx** | 🌐 | `hot-rank` | | **ths** | 🌐 | `hot-rank` | | **tieba** | 🌐 | `hot` `search` `posts` `read` | | **tiktok** | 🌐 | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | | **toutiao** | 🌐 | `hot` `articles` | | **tvmaze** | ✅ | `search` `show` | | **twitter** | 🌐 | `trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `bookmark-folders` `post` `like` `likes` `reply` `quote` `retweet` `unretweet` `delete` `block` `unblock` `followers` `following` `notifications` `download` `lists` `list-tweets` `list-add` `list-remove` `tweets` `unlike` `spaces` | | **uisdc** | 🌐 | `news` | | **uiverse** | 🌐 | `code` `preview` | | **v2ex** | ✅🌐 | Public: `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` · Browser: `daily` `me` `notifications` | | **wanfang** | 🌐 | `search` | | **web** | 🌐 | `read` — any URL to Markdown | | **weibo** | 🌐 | `hot` `search` `feed` `user` `me` `post` `comments` | | **wikidata** | ✅ | `search` `entity` | | **wikipedia** | ✅ | `search` `summary` `random` `trending` | | **weixin** | 🌐 | `download` — 公众号 article to Markdown | | **weread** | 🌐 | `shelf` `search` `book` `highlights` `notes` `notebooks` `ranking` | | **wttr** | ✅ | `current` `forecast` | | **xianyu** | 🌐 | `search` `item` `chat` | | **xiaoe** | 🌐 | `courses` `catalog` `content` `detail` `play-url` | | **xiaohongshu** | 🌐 | `search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | | **xiaoyuzhou** | ✅ | `podcast` `podcast-episodes` `episode` | | **xueqiu** | 🌐 | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `comments` `earnings-date` `fund-holdings` `fund-snapshot` | | **yahoo** | 🌐 | `search` | | **yahoo-finance** | 🌐 | `quote` | | **yollomi** | 🌐 | `models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale` | | **youtube** | 🌐 | `search` `video` `transcript` `feed` `history` `channel` `playlist` `comments` `like` `unlike` `subscribe` `unsubscribe` `subscriptions` `watch-later` | | **yuanbao** | 🌐 | `new` `ask` | | **zhihu** | 🌐 | `hot` `search` `question` | | **zlibrary** | 🌐 | `search` `info` | | **zsxq** | 🌐 | `groups` `dynamics` `topics` `topic` `search` | ### Desktop Apps (CDP/Electron) | App | Commands | |-----|----------| | **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | | **chatgpt-app** | `status` `new` `send` `read` `ask` `model` | | **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | | **codex** | `status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` | | **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | | **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | | **doubao-app** | `status` `new` `send` `read` `ask` `screenshot` `dump` | | **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | ### External CLI (passthrough) | CLI | Installed | Description | |-----|-----------|-------------| | **gh** | ✅ | GitHub CLI — repos, PRs, issues, releases | | **obsidian** | ✅ | Obsidian vault — notes, search, tags | | **docker** | ✅ | Docker CLI | | **lark-cli** | ✅ | Lark/Feishu — messages, docs, calendar, tasks (200+ commands) | | **vercel** | ✅ | Vercel — deploy, domains, env vars, logs | | **wx** | ✅ | WeChat local data CLI — sessions, messages, search, export | | **discord** | ❌ | Discord CLI | | **dws** | ❌ | DingTalk Workspace | | **longbridge** | ❌ | Longbridge CLI — market data, account, trading | | **ntn** | ❌ | Notion CLI | | **tg** | ❌ | Telegram CLI | | **wecom-cli** | ❌ | WeCom/企业微信 | ```bash opencli external install discord # Install external CLI opencli external list # Show all external CLIs opencli gh pr list --limit 5 # Passthrough to gh opencli wx messages # Passthrough to wx-cli ``` ### Management Commands ```bash opencli list [-f json|yaml] # All available commands opencli doctor # Diagnose extension + daemon opencli daemon status|restart|stop # Daemon control opencli adapter eject [site] # Eject adapter to ~/.opencli/clis/ for local editing opencli adapter reset [site] # Reset ejected adapter to upstream opencli profile list|use|rename # Chrome profile management opencli plugin list|install|update # Plugin management ``` --- ## Browser Automation Control Chrome step-by-step. Reuses existing login sessions. ### Critical Rules 1. **Always `state` first** — never guess element indices. `state` returns structured DOM with `[N]` indices, is instant and costs zero tokens. 2. **Never use `eval` to click or type** — use `click ` and `type "text"` instead. 3. **Verify inputs with `get value`** — after `type`, run `get value ` to confirm. 4. **Run `state` after every page change** — after `open`, `click` (on links), `scroll`. 5. **Chain commands aggressively** — `open + state`, `type + type + click` in one `&&` chain. Target 3-5 tool calls total. 6. **`eval` is read-only** — use ONLY for data extraction (`JSON.stringify(...)`), never for clicking/typing/navigating. 7. **Prefer `network` to discover APIs** — JSON APIs are more reliable than DOM scraping. ### Command Cost Guide | Cost | Commands | |------|----------| | Free & instant | `state`, `get *`, `eval`, `network`, `scroll`, `keys` | | Free but changes page | `open`, `click`, `type`, `select`, `back` | | Expensive (vision) | `screenshot` — ONLY when user needs a saved image | ### Commands ```bash # Navigation opencli browser open opencli browser back opencli browser scroll down|up [--amount N] # Inspect (free) opencli browser state # Primary — structured DOM with [N] indices opencli browser screenshot [path.png] # Only for user deliverables # Get (free) opencli browser get title|url|html opencli browser get text|value|attributes # Interact opencli browser click opencli browser type "text" opencli browser select "option" opencli browser keys "Enter" # Enter, Escape, Tab, Control+a # Wait opencli browser wait time 3 opencli browser wait selector ".loaded" [--timeout 5000] opencli browser wait text "Success" # Extract (read-only) opencli browser eval "JSON.stringify([...document.querySelectorAll('h2')].map(e => e.textContent))" # Network (API discovery) opencli browser network opencli browser network --detail 3 # Full response body of request #3 # Save as CLI opencli browser init hn/top # Scaffold adapter at ~/.opencli/clis/hn/top.ts opencli browser verify hn/top # Test the adapter opencli browser close ``` ### Chaining Examples ```bash # GOOD: open + inspect in one call opencli browser open https://example.com && opencli browser state # GOOD: fill form in one call opencli browser type 3 "hello" && opencli browser type 4 "world" && opencli browser click 7 # GOOD: click + wait + state (for page-changing clicks) opencli browser click 12 && opencli browser wait time 1 && opencli browser state ``` ### Troubleshooting | Error | Fix | |-------|-----| | "Browser not connected" | Run `opencli doctor` | | "attach failed: chrome-extension://" | Disable 1Password temporarily | | Element not found | `opencli browser scroll down && opencli browser state` | | Stale indices after page change | Run `opencli browser state` again | --- ## Auto-Fix Broken Adapters When an `opencli` command fails because a website changed its DOM/API, **automatically diagnose, fix, and retry** — don't just report the error. ### Safety Boundaries - **`AUTH_REQUIRED`** (exit 77) — STOP. Tell user to log in. Do not modify code. - **`BROWSER_CONNECT`** (exit 69) — STOP. Tell user to run `opencli doctor`. - **CAPTCHA / rate limiting** — STOP. Not an adapter issue. - **Only modify** the file at `RepairContext.adapter.sourcePath`. Never touch `src/`, `extension/`, `tests/`, `package.json`. - **Max 3 repair rounds** per failure. ### Before Repairing: "Empty" ≠ "Broken" `EMPTY_RESULT` is often NOT a bug — platforms degrade results under anti-scrape heuristics. Before patching: - Retry with an alternative query (e.g., `"AI 攻略"` vs `"AI"`) - Spot-check in a normal Chrome tab — if visible there but empty via adapter, it's auth/rate-limit - `0 results` from a search is a valid answer, not a bug ### Repair Workflow **Step 1: Collect diagnostics** ```bash OPENCLI_DIAGNOSTIC=1 opencli [args...] 2>diagnostic.json cat diagnostic.json | sed -n '/___OPENCLI_DIAGNOSTIC___/{n;p;}' ``` Output is a `RepairContext` JSON with: `error.code`, `adapter.sourcePath`, `adapter.source`, `page.snapshot`, `page.networkRequests`. **Step 2: Classify the failure** | Error Code | Likely Cause | Strategy | |-----------|-------------|----------| | SELECTOR | DOM restructured | Explore current DOM → find new selector | | EMPTY_RESULT | API response schema changed | Check network → find new response path | | API_ERROR | Endpoint URL changed | Discover new API via network intercept | | AUTH_REQUIRED | Cookies expired | **STOP** — tell user to log in | | TIMEOUT | Page loads differently | Add/update wait conditions | **Step 3: Explore live site** ```bash # DOM changed opencli browser open https://example.com/target-page && opencli browser state # API changed opencli browser open https://example.com && opencli browser network opencli browser network --detail ``` **Step 4: Patch the adapter** Read `RepairContext.adapter.sourcePath` and make minimal targeted fixes: - Selector update: replace `.old-class` with `.new-class` - API endpoint: update URL in `fetch()` - Response schema: fix data path (`data.results` → `data.data.items`) **Step 5: Verify** ```bash opencli [args...] # Run without diagnostic mode ``` If still failing, go back to Step 1. After 3 rounds, stop and report what was tried. --- ## Create New Adapters ### Quick Method (4 steps — for a single URL + goal) 1. **Open page + capture API** ```bash # Navigate and wait 3-5s for page to load # Check network for JSON APIs opencli browser open && opencli browser wait time 3 && opencli browser network ``` 2. **Lock down the target API** — find the one returning `application/json` with the data you need 3. **Verify the API is reusable** ```bash # Test in browser context fetch('/api/endpoint', { credentials: 'include' }).then(r => r.json()) ``` 4. **Write adapter from template** (see templates below) **Auth decision tree:** ``` fetch(url) works? → Tier 1: PUBLIC (browser: false) fetch(url, {credentials:'include'}) works? → Tier 2: COOKIE (most common) Needs Bearer/CSRF header? → Tier 3: HEADER Page requests it but fetch can't? → Tier 4: INTERCEPT (installInterceptor) ``` ### Adapter Templates **Tier 1 — Public API (fastest)** ```typescript // ~/.opencli/clis//.ts import { cli, Strategy } from '@jackwener/opencli/registry'; cli({ site: 'mysite', name: 'hot', description: '一句话描述', domain: 'www.example.com', strategy: Strategy.PUBLIC, browser: false, args: [{ name: 'limit', type: 'int', default: 20 }], columns: ['rank', 'title', 'score'], func: async (_page, kwargs) => { const res = await fetch('https://api.example.com/hot'); const data = await res.json(); return data.items.slice(0, kwargs.limit).map((item: any, i: number) => ({ rank: i + 1, title: item.title, score: item.score, })); }, }); ``` **Tier 2 — Cookie auth (most common)** ```typescript import { cli, Strategy } from '@jackwener/opencli/registry'; cli({ site: 'mysite', name: 'feed', description: '一句话描述', domain: 'www.example.com', strategy: Strategy.COOKIE, browser: true, args: [{ name: 'limit', type: 'int', default: 20 }], columns: ['rank', 'title', 'value'], func: async (page, kwargs) => { await page.goto('https://www.example.com'); const data = await page.evaluate(`(async () => { const res = await fetch('/api/feed', { credentials: 'include' }); const d = await res.json(); return (d.data?.items || []).map(item => ({ title: item.title, value: item.value })); })()`); return (data as any[]).slice(0, kwargs.limit).map((item, i) => ({ rank: i + 1, title: item.title || '', value: item.value || '', })); }, }); ``` **Tier 4 — Intercept (for sites with signing/anti-scrape)** ```typescript import { cli, Strategy } from '@jackwener/opencli/registry'; cli({ site: 'mysite', name: 'feed', description: '一句话描述', domain: 'www.example.com', strategy: Strategy.INTERCEPT, browser: true, args: [{ name: 'limit', type: 'int', default: 20 }], columns: ['rank', 'title', 'value'], func: async (page, kwargs) => { await page.goto('https://www.example.com/target'); await page.wait(3); await page.installInterceptor('api-keyword'); // URL substring match await page.autoScroll({ times: 2, delayMs: 2000 }); // Trigger lazy load const requests = await page.getInterceptedRequests(); if (!requests?.length) return []; const results: any[] = []; for (const req of requests) { results.push(...(req.data?.data?.items || [])); } return results.slice(0, kwargs.limit).map((item, i) => ({ rank: i + 1, title: item.title || '', value: item.value || '', })); }, }); ``` ### Test After Writing ```bash npm run build # Syntax check opencli list | grep mysite # Confirm registered opencli mysite mycommand --limit 3 -v # Verify actual output ``` ### Full Exploration Guide (for new sites) When you need to explore a site from scratch rather than a single URL: **Step 1: API Discovery** ```bash opencli explore https://www.example.com --site mysite ``` Outputs to `.opencli/explore/mysite/`: `endpoints.json`, `capabilities.json`, `auth.json` Or auto-generate everything: ```bash opencli generate https://www.example.com --goal "hot" ``` **Key discovery tactics:** - **`.json` suffix trick** — Reddit-style sites: just append `.json` to URL for clean REST data - **`__INITIAL_STATE__`** — SSR sites (Bilibili, Xiaohongshu) embed data in `window.__INITIAL_STATE__` - **Active interaction** — Lazy-load APIs (comments, subtitles) only appear after clicking a button - **Pinia/Vuex intercept** — Vue sites: call store actions to trigger signed requests without reverse-engineering signatures **Step 2: Pick auth tier** — run `opencli cascade ` to auto-detect **Step 3: Find existing adapter to copy** — `ls clis//`, copy the closest one, change 3 fields: `name`, API URL, field mapping **Step 4: Test** ```bash opencli mysite hot --limit 3 -v # verbose: see pipeline data flow opencli mysite hot -f json | jq '.[0]' # confirm JSON structure ``` **Common pitfalls:** | Pitfall | Fix | |---------|-----| | Missing `navigate` before `evaluate` | Add `page.goto()` before evaluate | | Public API starts browser anyway | Add `strategy: Strategy.PUBLIC, browser: false` | | `evaluate` returns empty on SPA | Add `wait selector` or `wait time` before evaluate | | Cookie expired | Re-login in Chrome | | `EMPTY_RESULT` after intercept | Check if `installInterceptor` keyword matches actual URL |