Control the web
with precision.

// Start the CDP server
$ telemaco serve --port 9222

// puppeteer.js
import puppeteer from 'puppeteer-core';

const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://127.0.0.1:9222/devtools/browser',
});
const page = await browser.newPage();
await page.goto('https://news.ycombinator.com');

const stories = await page.evaluate(() =>
  Array.from(document.querySelectorAll('.titleline > a'))
    .map(a => ({ title: a.textContent, url: a.href }))
);
console.log(stories);

// Start the CDP server
$ telemaco serve --port 9222

// playwright.js
import { chromium } from 'playwright-core';

const browser = await chromium.connectOverCDP({
  endpointURL: 'ws://127.0.0.1:9222',
});
const page = await browser.newContext().then(ctx => ctx.newPage());
await page.goto('https://en.wikipedia.org/wiki/Web_scraping');
console.log(await page.title());

# Page title
$ telemaco fetch https://example.com --eval "document.title"

# Extract all links
$ telemaco fetch https://example.com --dump links

# Render JS and dump HTML
$ telemaco fetch https://news.ycombinator.com --dump html

# Screenshot the settled page
$ telemaco fetch https://example.com --screenshot page.png

# Scrape many URLs in parallel
$ telemaco scrape url1 url2 url3 --concurrency 25 --format json

# Keep telemaco current
$ telemaco update --check

{
  "mcpServers": {
    "telemaco": { "command": "telemaco", "args": ["mcp"] }
  }
}

# Or over HTTP
$ telemaco mcp --http --port 8080
→ endpoint: http://127.0.0.1:8080/mcp