Site Adapters & Awesome-List Targets

Directory Site Adapters

Generic Adapter (bb-browser)

Submit to any directory site without writing a custom adapter:

node src/cli.js submit https://example.com/submit --engine bb

Uses bb-browser's snapshot to auto-detect form fields (name, URL, email, description) and fill them from config.yaml. Requires engine: bb.

Awesome-List Targets

Engine Selection

Per-adapter engine override: adapters can declare engine: 'bb' to force bb-browser. The generic adapter does this automatically.

Priority: CLI --engine flag > adapter engine property > config.yaml browser.engine > default (playwright).

Adding New Site Adapters

Create src/sites/<sitename>.js:

import { withBrowser, delay } from '../browser.js';

export default {
  name: 'example.com',
  url: 'https://example.com/submit',
  auth: 'none',        // none | email | oauth
  captcha: 'none',     // none | color | recaptcha
  engine: 'bb',        // optional: force bb-browser for this adapter

  async submit(product, config) {
    return withBrowser(config, async ({ page }) => {
      await page.goto('https://example.com/submit', { waitUntil: 'networkidle' });
      // Fill form fields...
      // Submit...
      // Check confirmation...
      return { url: page.url(), confirmation: 'success message' };
    });
  },
};

Then use: node src/cli.js submit <sitename>

bb-browser Auto-Update

Community adapters update automatically when bb_browser.auto_update: true in config.yaml (default). Force update:

node src/cli.js bb-update

本文档为站内渲染。原始文件本地路径：saas/source/backlinks/外链提交-外链资料-2k买的发外链工具-外链自动化-backlink-pilot-main-adapters-b407b6.md（仅本地保留，不入库不部署）