Linkedin

LinkedIn skill

The browser is just an authenticated transport. The data lives in LinkedIn's own internal API (Voyager). Read from source, not the DOM. (DOM selectors returned 0 reliably; a Voyager fetch returned 217 KB of structured truth.)

Golden rules

1. API-first — every read is a Voyager fetch; DOM only for the few write

buttons.

1. Fail fast — ~8 s timeouts, not 60 s. After 5-6 s it's ~90 % a hard hang.
2. Prefer direct navigation to URLs over clicking links/buttons that

navigate (they hang).

1. Tab/focus discipline — list_pages before acting; new_page to isolate.
2. queryIds + selectors DRIFT — capture live each session; never hardcode.
3. Gate every write — acts as the user; explicit per-send confirmation.

Read this in order

• reference/transport.md — chain, lifecycle, tab/focus, timeouts, tool

gotchas.

• reference/voyager.md — the data layer: the fetch primitive + query

library + capture method + entity model.

• reference/recipes.md — read recipes (feed, profile, activity,

who-reacted/commented, connections, search + the identification scorer).

• reference/write-actions.md — message + attachment (✅ proven, API-first) +

the relationship graph (invite ±note / withdraw, ✅ via social_network / the trusted-input ladder; connect+withdraw are SDUI, not a fetch), gated, safety rails.

• reference/playbooks.md — the 100x layer: persona dossiers, the

engagement/relationship graph, discover→dossier→outreach.

Quickstart (once the browser is free)

1. health: api 3040 · tunnel 3600 · daemon 18790  (else: agentproto serve --connect ws://localhost:3600/connect)
2. navigate any linkedin.com page → liFetch(voyagerFeedDashMainFeed, …) → structured feed
3. for a person: search + score → persona.build → (gated) reach out

Harnesses: projects/guilde/apps/api/scripts/linkedin-explore.ts (feed/profile/search/req) and linkedin-message.ts (--send gated). Connect-with-note flow in write-actions.md.

Two transports — prefer camofox (stealth)

Same Voyager-API-first philosophy, two ways to be the authenticated page:

• Camofox (PREFERRED — stealth Firefox, distinct session). A dedicated

LinkedIn login native to camofox's fingerprint, separate from the daily-driver Chrome (so the site never bounces your real session). Auto-notifies on a login wall. Entry point: projects/browser/packages/social/scripts/social-scrape.mts (@agstudio/browser-social): `` tsx social-scrape.mts login linkedin --hold 300 # log in once, by hand, in the camofox window tsx social-scrape.mts linkedin --slices authored,connections tsx social-scrape.mts search linkedin "" # people → vanity tsx social-scrape.mts content linkedin "" [--limit 20] [--date-range past-week] ``

• Chrome chain (fallback). createLinkedInVoyager(createBrowser()) —

createLinkedInVoyager from @agstudio/browser-social, driving the createBrowser() port (scripts/lib/browser.ts) over guilde→tunnel→daemon→chrome-devtools-mcp. Uses your daily Chrome session (revoke risk).

Camofox auth gotcha (cost time once): the launchd :9377 camofox service (~/Library/LaunchAgents/com.agentik.camofox.plist) MUST set EnvironmentVariables/CAMOFOX_PROFILE_DIR = ~/.agentproto/camofox-profiles, else server.js never restores the persisted session (camofox-profiles/linkedin.json) and every tab bounces to /login despite a valid saved login. After fixing: launchctl unload/load the plist; userId="linkedin" restores authed (verify voyager/api/me → 200).

Auth-notify: on a login/anti-bot wall, makeChallengeHandler (social/scripts/lib/challenge.mts) WhatsApps you ("résous dans la fenêtre camofox, je reprends") via resolveAlertChannel (Simone number, WHATSAPP_ADMIN_PHONES), then polls until cleared. Fires only on isBlocked().

Content search (who posted about a topic)

LinkedIn content search is 100% RSC — hashed DOM, no client-side URNs, and all Voyager /search/* routes are dead (404/400/500). So content linkedin (and the Chrome searchContent) walk the rendered result cards from author anchors, then resolve real activity permalinks post-hoc per /in/ author via Voyager profileUpdates + exact normalized-text match (no false positives). /company/ authors keep the profile URL. People search (search linkedin) reads the SSR cards passively instead.

Status

✅ proven live: chain, Voyager fetch, feed/profile/activity endpoints, search+scorer, message SEND + PDF/file attachment, inbox READ + media download, relationship withdraw (productized social_network + social-cancel-request workflow; read-back classifies connectable live). ✅ camofox transport — userId="linkedin" session restore (authed 200), content linkedin search + post-hoc permalink resolution, WhatsApp challenge-handler wired. ⏳ to capture: who-reacted / who-commented / per-person reactions+comments queryIds — methods in voyager.md; DM-react (SDUI-walled).

> Foundation mechanics (transport, capture, cookies/consent, the > find-the-internal-API method, gated writes): the browser skill. Other > sites are their own skills: x-twitter · youtube · instagram · tiktok · > leboncoin · news-media. LinkedIn is the deepest worked instance.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: agentproto
• Source: agentproto/ts
• License: Apache-2.0
• Homepage: https://agentproto.sh

Install and usage instructions live in the source repository linked above.