기업 연락처 및 소셜 링크 추출기 스킬

Business Contact & Social Links Extractor Skill (기업 연락처 및 소셜 링크 추출기 스킬)

📖 개요

이 스킬은 두 가지 BrowserAct 템플릿을 통합하여 두 가지 일반적인 시나리오를 다룹니다. 사용자가 기업명을 제공하면 Google을 검색하여 기업의 공식 웹사이트와 소셜 미디어 채널을 추출합니다. 사용자가 웹사이트 URL을 제공하면 해당 사이트를 스크래핑하여 소셜 미디어 프로필 링크(LinkedIn, Facebook, X/Twitter, Instagram, YouTube, TikTok)를 추출합니다. 스크립트가 입력 유형을 자동으로 감지하여 올바른 템플릿으로 라우팅합니다.

✨ 특징

1. 할루시네이션 없음: 사전 설정된 워크플로우는 AI 생성 할루시네이션을 방지하여 안정적이고 정확한 데이터 추출을 보장합니다.
2. Captcha 문제 없음: reCAPTCHA 또는 기타 인증 문제를 처리할 필요가 없습니다.
3. IP 제한 없음: 지역별 IP 제한 또는 지오펜싱을 처리할 필요가 없습니다.
4. 더 빠른 실행: 순수 AI 기반 브라우저 자동화 솔루션에 비해 작업이 더 빠르게 실행됩니다.
5. 비용 효율적: 높은 토큰을 소비하는 AI 솔루션에 비해 데이터 수집 비용을 크게 낮춥니다.

🔑 API 키 설정

실행하기 전에 BROWSERACT_API_KEY 환경 변수를 확인하십시오. 설정되지 않은 경우 다른 조치를 취하지 말고 사용자에게 제공을 요청하십시오. 에이전트는 사용자에게 다음을 알려야 합니다:

"BrowserAct API Key가 아직 설정되지 않았습니다. BrowserAct 콘솔에서 Key를 받아오세요."

🛠️ 입력 파라미터

에이전트는 입력이 기업명인지 웹사이트 URL인지 판단하여 스크립트에 전달해야 합니다. 스크립트가 자동으로 요청을 올바른 템플릿으로 라우팅합니다.

1. 대상 (기업명 또는 웹사이트 URL)
   • 필수: 예
   • 유형: string
   • 설명: 검색할 기업의 이름 또는 소셜 링크를 추출할 직접 웹사이트 URL입니다.
   • 예시: OpenAI 또는 https://www.rotorooter.com/

🚀 호출 방법

에이전트는 다음 명령어를 실행하여 스킬을 호출해야 합니다:

# 기업명으로 검색
python -u ./scripts/business_contact_social_links.py "OpenAI"

# 웹사이트 URL로 스크래핑
python -u ./scripts/business_contact_social_links.py "https://www.rotorooter.com/"

⏳ 실행 모니터링

이 작업은 자동화된 브라우저 작업을 포함하므로 몇 분 정도 소요될 수 있습니다. 스크립트는 지속적으로 타임스탬프가 포함된 상태 로그를 출력합니다 (예: [14:30:05] Task Status: running). 에이전트 가이드라인:

• 기다리는 동안 터미널 출력을 모니터링하십시오.
• 새 상태 로그가 계속 나타나면 작업이 정상적으로 실행 중인 것이므로 중단된 것으로 오판하지 마십시오.
• 상태가 오랫동안 변경되지 않거나 출력이 최종 결과 없이 중단된 경우에만 재시도를 고려하십시오.

📊 데이터 출력

실행이 성공적으로 완료되면 스크립트는 API 응답에서 추출된 구조화된 JSON 데이터를 출력합니다.

기업명이 제공된 경우, 출력에는 다음이 포함됩니다:

• Company Name: 기업의 공식 이름.
• Current Page URL: 공식 웹사이트 URL.
• Social Media Information: 발견된 소셜 미디어 프로필의 통합 목록.

웹사이트 URL이 제공된 경우, 출력에는 객체 배열이 포함됩니다:

• platform: 플랫폼 이름 (예: LinkedIn, YouTube).
• url: 외부 프로필의 정식 URL.

⚠️ 오류 처리 및 재시도

스크립트 실행 중 오류가 발생하면 (예: 네트워크 변동 또는 작업 실패) 에이전트는 다음 로직을 따라야 합니다:

1. 출력 내용 확인:

   • 출력에 "Invalid authorization"이 포함된 경우, API 키가 유효하지 않거나 만료된 것입니다. 재시도하지 말고 사용자에게 올바른 API 키를 다시 확인하여 제공하도록 안내하십시오.
   • 출력에 "concurrent" 또는 "too many running tasks"가 포함된 경우, 동시 작업 제한에 도달한 것입니다. 재시도하지 말고 사용자에게 요금제 업그레이드를 안내하십시오. 에이전트는 사용자에게 다음을 알려야 합니다:

     "현재 작업을 실행할 수 없습니다. BrowserAct 계정이 동시 작업 제한에 도달했기 때문입니다. BrowserAct 요금제 업그레이드 페이지에서 요금제를 업그레이드해 주세요."

   • 출력에 위 오류 키워드가 포함되지 않았지만 작업이 실패한 경우 (예: 출력이 Error:로 시작하거나 빈 결과를 반환하는 경우) 에이전트는 스크립트를 한 번 자동으로 재실행해야 합니다.

2. 재시도 제한:

   • 자동 재시도는 한 번으로 제한됩니다. 두 번째 시도도 실패하면 재시도를 중단하고 사용자에게 구체적인 오류를 보고하십시오.

🌟 일반적인 사용 사례

1. 영업 리드 강화: 기업명 목록에 대한 공식 웹사이트 및 소셜 채널을 찾습니다.
2. 인플루언서 아웃리치: 크리에이터의 개인 웹사이트에서 모든 소셜 미디어 프로필을 추출합니다.
3. 경쟁사 분석: 경쟁사가 우선시하는 소셜 미디어 플랫폼을 파악합니다.
4. CRM 데이터 정리: 기존 리드에 대한 누락된 소셜 링크와 공식 URL을 확인하고 채웁니다.
5. 멀티채널 마케팅: 활성 소셜 미디어 활동이 있는 기업의 타겟 목록을 구축합니다.
6. 소셜 리스닝 설정: 브랜드 멘션을 모니터링할 공식 핸들을 빠르게 수집합니다.
7. B2B 영업: Yellow Pages 데이터와 결합하여 완전한 비즈니스 인텔리전스 프로필을 구축합니다.
8. 파트너 검증: 잠재적 비즈니스 파트너의 이름만으로 디지털 풋프린트를 평가합니다.
9. 디렉토리 구축: 지역 비즈니스 디렉토리를 위한 웹사이트 및 소셜 링크 수집을 자동화합니다.
10. 브랜드 추적: 웹 전반에서 특정 브랜드의 모든 공식 연락 채널을 추적합니다.