playbook-social-link-finding

Resolve company domains to verified official social profile URLs across six platforms.

Updated May 28, 2025
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill playbook-social-link-finding-meloshaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playbook-social-link-finding
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/playbooks/playbook-social-link-finding
Command: npx skills add https://github.com/meloShaya/insteltech --skill playbook-social-link-finding-meloshaya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding a company's official social profiles is error-prone: search results return similarly named companies, squatted handles, and post URLs instead of profiles, and a wrong URL silently poisons every downstream personalization workflow that scrapes behind it. ## Core Features & Use Cases - Multi-source resolution chain: Combines an internal company database, a company-search API, direct website HTML fetching, a rendering proxy for bot-blocked sites, and SERP search, with cost tags per source. - Mandatory ownership verification: A locked model prompt verifies every candidate that did not come from the company's own website, rejecting decoys, fan pages, employee profiles, and non-profile URLs like instagram.com/p/ or tiktok.com/discover/. - Platform-specific hard rules: X handles require company-site evidence only, batch API results must be chunked to the 25-per-page limit, and HTTP-200 challenge pages are detected by body content rather than status code. - Use Case: Given a list of target company domains for an outbound campaign, produce one canonical LinkedIn, X, Facebook, Instagram, YouTube, and TikTok URL per company, each with an evidence-source column, ready to feed engagement-scraping or ad-library playbooks. ## Quick Start Find the official LinkedIn, Instagram, and TikTok profile URLs for the company at example.com and verify each one belongs to that company.

Frequently Asked Questions about playbook-social-link-finding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a company's official LinkedIn URL from its domain?

Look up the domain in a company database or search API first, then fetch the company's own website HTML and extract linkedin.com/company/ links from the footer. Site-footer links are self-attested; anything from search or databases must pass an ownership verification prompt before use.

How do I verify a social media profile belongs to a specific company?

Run the candidate URL through a model verifier prompt with the company name, domain, platform, and evidence source. It returns owned true or false, rejecting fan pages, resellers, employee profiles, and post or discovery URLs, plus a canonicalized URL and confidence level.

Why does a batch company-search API return fewer results than expected?

Many company-search endpoints are hard-paginated at 25 results per page with no page-size parameter, so a 500-domain request returns only 25 matches silently. Chunk requests to the page size and loop the page parameter through total_page.

Why can't I find a company's X (Twitter) handle through search?

X handles are short, recycled, and squatted, so search results often return handles that match the brand better than the real account. This playbook requires company-website evidence for X from every path and rejects all search-derived or database-derived X candidates.

What should I do when a website blocks scraping but shows HTTP 200?

Check the response body, not just the status code: bot challenge pages are often served with HTTP 200 and look like clean misses. Detect challenge phrases or bodies under 2000 characters, then escalate to a rendering proxy to recover the real page.

When should I not use this social link finding playbook?

Do not use it to find a person's individual profile, to pull post-level engagement data, or to read ad libraries. Those belong to separate playbooks; this one only outputs one canonical company profile URL per platform or an empty string.