Skip to content
Back to search

visitor-id

SkillWorks with Claude CodeGitHub

Website visitors → outreach signals: Cloudflare Worker + D1 receives RB2B or company-by-IP visits, exports a signal CSV for the prospect list. Claude Code skill. By Victor Shulga (Fractional CRO).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/victor-shulga--visitor-id/badge.svg)](/listings/victor-shulga--visitor-id)

HTML

<a href="/listings/victor-shulga--visitor-id"><img src="/api/listings/victor-shulga--visitor-id/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 114 lines
  1. # Visitor ID: хто заходив на сайт
  2. Встановити як скіл Claude Code (Claude сам розгорне все, що нижче):
  3. ```bash
  4. npx skills add victor-shulga/visitor-id
  5. ```
  6. Або руками: `git clone https://github.com/victor-shulga/visitor-id.git && cd visitor-id`, далі розділ «Встановлення».
  7. Візит на сайт є сигналом інтенту: людина вже знає про вас. Цей репозиторій збирає візити в одну базу і віддає їх в аутріч тим самим CSV, що й [сигнал-радар](https://github.com/victor-shulga/signal-radar-starter): компанія, дата, сторінка-доказ, черга A/B.
  8. ## Що реально можна дізнатися
  9. | Шлях | Що отримуєте | Де працює | Ціна |
  10. |---|---|---|---|
  11. | **RB2B** | людину: ім'я, посада, LinkedIn, компанія | лише відвідувачі зі США | безкоштовний план → Slack; вебхук на платному |
  12. | **Компанія за IP** (LinkedIn Insight Tag, Snitcher, Leadfeeder, Dealfront) | лише компанію | будь-яка країна, офісний трафік | від $0 до ~$100/міс |
  13. | **Свої посилання з міткою** (`?ref=<id>` у листах, вхід через LinkedIn на лід-магніті) | людину, яку ви вже знаєте | будь-яка країна | $0 |
  14. Людину за візитом RB2B визначає через cookie трьох рекламних мереж США: вони повертають хеш пошти, якщо вже бачили цей браузер. За межами США цього не повторити ні технічно, ні законно, тому для Європи працюють лише компанія за IP і свої мітки.
  15. ## Requirements & integrations
  16. | Integration | Used for | Required? | Auth/setup |
  17. |---|---|---|---|
  18. | RB2B або інший інструмент з вебхуком | візити | так, один із | вебхук на `https://<ваш-воркер>/hook/<HOOK_SECRET>` |
  19. | Cloudflare Workers + D1 | прийом і зберігання візитів | так | `npx wrangler login` |
  20. | Slack | безкоштовний план RB2B шле лише сюди | ні | канал RB2B → Claude читає його щодня |
  21. | python3, node | експорт і тести | так | не потрібно |
  22. ## Файли
  23. | Файл | Що робить |
  24. |---|---|
  25. | `worker.js` | приймає вебхук, пише візит у D1, завжди швидко відповідає 200 |
  26. | `schema.sql` | таблиця `visit` |
  27. | `wrangler.toml` | назва воркера і база |
  28. | `export.py` | візити за N днів → `state/visitor_signals.csv` у форматі сигналів радара |
  29. | `test.mjs`, `test_export.py` | перевірки без мережі |
  30. | `skills/visitor-id/SKILL.md` | скіл: Claude проводить через встановлення, джерело і щотижневий експорт |
  31. ## Встановлення
  32. ```bash
  33. node test.mjs && python3 test_export.py # visitor-id test ok, export test ok
  34. npx wrangler login
  35. npx wrangler d1 create visitor-id # database_id → wrangler.toml
  36. npx wrangler d1 execute visitor-id --remote --file=schema.sql
  37. npx wrangler secret put HOOK_SECRET # довгий випадковий рядок
  38. npx wrangler deploy
  39. ```
  40. Далі в RB2B: Integrations → Webhook → адреса `https://visitor-id.<ваш-акаунт>.workers.dev/hook/<HOOK_SECRET>`. Перевірка: `curl https://.../health` повертає `ok`.
  41. RB2B вимикає інтеграцію, якщо відповідь не 200 або довша за 15 секунд, тому воркер нічого не рахує, лише записує.
  42. **Безкоштовний план RB2B (лише Slack).** Вебхука немає. Поставте Claude щоденну задачу: «Прочитай канал RB2B у Slack за вчора, кожне повідомлення перетвори на JSON з полями LinkedIn URL, First Name, Last Name, Title, Company Name, Website, Captured URL, Seen At і надішли POST на адресу хука». Далі все так само.
  43. **Компанія за IP.** Більшість таких інструментів теж уміє вебхук або CSV. Поля `Company Name`, `Website`, `Captured URL`, `Seen At`, цього достатньо, воркер приймає візит без людини.
  44. ## Мітки: звідки прийшов візит
  45. Без міток видно лише сторінку. З мітками видно, з якого каналу і якої кампанії прийшла людина, а з `ref` ще й хто саме. Мітки працюють у будь-якій країні: тут не треба ні RB2B, ні IP.
  46. Два види міток:
  47. | Мітка | Що каже | Приклад |
  48. |---|---|---|
  49. | `utm_source` | канал | `linkedin`, `email`, `post`, `signature`, `leadmagnet` |
  50. | `utm_medium` | тип дотику | `outreach`, `organic`, `dm` |
  51. | `utm_campaign` | гіпотеза або кампанія, тією ж назвою, що в HeyReach чи Instantly | `long-hiring` |
  52. | `ref` | конкретний контакт: його ID у CRM | `ref=48213` |
  53. Правила: латиниця, малі літери, дефіс замість пробілу. Одна назва кампанії скрізь: у розсилці, в мітці, в CRM. Інакше їх не зведеш.
  54. **Куди ставити**
  55. | Де посилання | Шаблон |
  56. |---|---|
  57. | лист в Instantly | `https://site.com/cases?utm_source=email&utm_medium=outreach&utm_campaign=long-hiring&ref={{crm_id}}` |
  58. | повідомлення в HeyReach | `https://site.com/cases?utm_source=linkedin&utm_medium=outreach&utm_campaign=long-hiring&ref={crm_id}` |
  59. | пост у LinkedIn | `https://site.com/offer?utm_source=post&utm_medium=organic&utm_campaign=2026-11-26` |
  60. | підпис у пошті | `https://site.com/?utm_source=signature&utm_medium=email` |
  61. | лід-магніт в особистих | `https://site.com/guide?utm_source=leadmagnet&utm_medium=dm&ref={crm_id}` |
  62. `{{crm_id}}` і `{crm_id}` означають власне поле контакту в розсилці. Заведіть його при завантаженні списку і кладіть туди ID контакту з HubSpot.
  63. **Ніколи не кладіть у посилання пошту чи ім'я людини.** Адреса потрапляє в логи, аналітику й чужі пересилання. Лише ID, за яким людину знайдете тільки ви.
  64. Внутрішні посилання сайту міток не мають: мітка на переході між вашими сторінками затирає справжнє джерело.
  65. **Що буде в CSV.** `export.py` читає мітки з адреси сторінки і додає колонки `utm_source`, `utm_campaign`, `ref`. Візит із `ref` означає, що відома людина повернулась. Він завжди йде в чергу A, навіть якщо ні RB2B, ні IP компанію не впізнали.
  66. **Заявки з форми.** Якщо на сайті стоїть код відстеження HubSpot, UTM візиту, після якого людина лишила заявку, HubSpot записує в джерело контакту сам. Так видно, яка кампанія привела заявку.
  67. ## Як візит іде в аутріч
  68. ```bash
  69. python3 export.py --days 7
  70. ```
  71. - **A**: дивився ціни, кейси, контакти чи послуги, або заходив 3+ рази. Пишемо цього тижня.
  72. - **B**: решта. Чекаємо другого сигналу.
  73. Перед листом компанія проходить ті самі стоп-фільтри, що й решта: ICP, розмір, поточні клієнти, конкуренти. Людину без LinkedIn шукаємо як ОПР під компанією.
  74. **Не пишіть, що бачили людину на сайті.** Вона про це не знає, і такий початок відштовхує. Привід для листа: тема сторінки, яку вона дивилась.
  75. ## Готово, коли
  76. - [ ] `curl .../health` повертає `ok`, тестовий візит з'явився в D1
  77. - [ ] Перший тиждень візитів вивантажено, A-компанії перевірені очима
  78. - [ ] A-компанії з ICP потрапили в CRM із сигналом «візит» і датою

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.