{
  "markdown": "# familiar\nControl your real macOS Chrome via AppleScript — no DevTools Protocol, no Playwright.\n\nA Claude Code skill that drives Google Chrome on macOS through AppleScript (Apple\nEvents). It uses your everyday browser instead of a headless/automated one, so pages\nbehind bot/WAF defenses tend to treat it as a normal user.\n\n日本語版は [README.ja.md](README.ja.md) を参照してください。\n\n## What it does\n\nEverything is tab-scoped (windowId + tabId); it never relies on the \"active tab\".\n\n- `list_tabs` / `new_tab` / `new_incognito_tab` / `close_tab` — tab management (new_tab uses a normal window, new_incognito_tab an incognito one)\n- `active_tab` / `window_mode` / `is_loading` — inspect active tab / window mode / tab loading state\n- `navigate` / `get_tab_url` — navigation\n- `reload` / `go_back` / `go_forward` / `stop` — history & reload control\n- `wait_for_load` / `wait_for_selector` / `wait_for_function` — wait for page load / element / a JS condition\n- `get_html` — get the current DOM as HTML\n- `get_text` / `get_attribute` / `get_value` / `exists` / `query_all` — read element text / attribute / value / presence / all matches\n- `click` / `fill` / `clear` / `select_option` / `set_checked` / `press_key` / `submit` / `scroll_into_view` — interact with elements and forms\n- `execute_js` / `execute_js_file` — run arbitrary JavaScript (use the file form for complex scripts)\n\nSelectors accept CSS (default), `text=`, `xpath=`, and `label=` forms.\n\n## Prerequisites\n\n- macOS with Google Chrome\n- Enable Chrome's \"Allow JavaScript from Apple Events\"\n  (View → Developer → Allow JavaScript from Apple Events)\n- Approve the Automation permission prompt on first run\n\n## Install\n\n### Claude Code plugin\n\n```\n/plugin marketplace add dominion525/familiar\n/plugin install familiar@familiar\n```\n\nFor local development / testing:\n\n```\n/plugin marketplace add /path/to/familiar\n/plugin install familiar@familiar\n```\n\n### Vercel Skills (agent-skills)\n\n```\nnpx skills add dominion525/familiar\n```\n\nThis places the skill under `~/.agents/skills/familiar/`. Any client that follows the\n[agent-skills spec](https://agentskills.io/specification) (Claude Code, Cursor, and\nothers) picks it up automatically. The registry is at https://skills.sh.\n\n### MCP server\n\nThe `mcp/` directory contains an MCP server implementation (TypeScript) that\nexposes the same 32 actions to any MCP-compatible client (Claude Code, Claude\nDesktop, Cursor, Codex CLI, and others).\n\nQuick install (Claude Code):\n\n```bash\nclaude mcp add familiar -- npx @dominion525/familiar-mcp@latest\n```\n\nSee [mcp/README.md](mcp/README.md) for full per-client install and configuration.\n\n### Standalone (no install)\n\nThe script also runs standalone, without installing the skill:\n\n```\nosascript skills/familiar/familiar.applescript list_tabs\n```\n\nSee `skills/familiar/SKILL.md` for full usage.\n\n## License\n\nMIT\n",
  "bytes": 2849,
  "sha": "b2309b77799b68223fd1b044afe6d87d9137a08111b343c674190c77e80e26b7",
  "repo_slug": "dominion525/familiar",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dominion525_familiar_mcp_7dadf1ac/readme"
}