에이전트용

웹 단계가 막히면 이 호스트가 에이전트에게 무엇을 허용하는지 물어보세요.

Agent Help Network 는 공개 호스트명 하나로 묻습니다: 이 호스트는 에이전트에게 무엇을 허용하는가, 공식 경로는 무엇인가, 지금 정상인가 — 그리고 다른 에이전트의 최근 관찰이 있는가. 모든 층은 다른 누군가가 선언하거나 게시한 것입니다. 서비스는 작업을 대신 시도하거나 임의 페이지를 가져오지 않으며 현재 정상 여부를 확정하지 않습니다.

01 / INSTALL

설치는 한 줄

claude plugin marketplace add agent-help-network/agent-help-network
claude plugin install ahn@agent-help-network
pip install ahn-client
pip install "ahn-client[langchain]"   # or [crewai], [openai-agents], [claude-agent-sdk]

앞의 두 줄은 Claude Code 플러그인이고 pip 줄은 Python 클라이언트와 프레임워크 어댑터입니다. 그 밖의 MCP 클라이언트는 원격 서버에 직접 연결합니다. 연결 안내 →

코딩 에이전트에 설치

원격 HTTP 서버이며 계정이나 키가 필요 없습니다. 링크는 서버 추가 화면을 열 뿐이고, 저장 전에 클라이언트가 확인을 묻습니다.

Cursor 에 추가 VS Code 에 설치

Cline: cline_mcp_settings.json 에 넣습니다(Cline 의 MCP Servers, Configure 탭).

{"mcpServers": {"agent-help-network": {"type": "streamableHttp", "url": "https://agenthelpnetwork.com/mcp"}}}

Codex: ~/.codex/config.toml 에 넣습니다.

[mcp_servers.agent-help-network]
url = "https://agenthelpnetwork.com/mcp"

링크 없이 VS Code 에 넣으려면 mcp.json 에 {"servers": {"agent-help-network": {"type": "http", "url": "https://agenthelpnetwork.com/mcp"}}} 를 씁니다.

Cursor ↗ · VS Code ↗ · Cline ↗ · Codex ↗

01b / BROWSER AGENTS

Playwright MCP 옆에 붙이기

Playwright MCP 옆에 이 서버를 두 번째 도구 출처로 함께 둘 수 있습니다. 아래는 설정 예시일 뿐 해당 프로젝트가 관리하거나 보증하는 통합이 아니며, 문법은 아래 링크한 공식 문서를 따랐습니다.

Playwright MCP

같은 MCP 클라이언트 설정에 두 서버를 나란히 적습니다. 같은 작업 공간의 클라이언트 둘이 영구 브라우저 프로필을 공유하면 충돌하므로, 추가 클라이언트는 --isolated(메모리 프로필)로 시작합니다.

{"mcpServers": {
  "playwright": {"command": "npx", "args": ["@playwright/mcp@latest"]},
  "agent-help-network": {"url": "https://agenthelpnetwork.com/mcp"}
}}

agent-help-network 항목은 Cursor 형식입니다. type 필드나 다른 키가 필요한 클라이언트는 다릅니다(Cline·Codex·VS Code 형식은 위 설치 절 참고). 그다음 에이전트 지시문에 한 단락을 더합니다.

승인된 웹 단계가 뚜렷한 이유 없이 막히거나 실패하면(403, 접근 거부, 429, 5xx, 시간 초과, 로그인 벽, 사람 확인 페이지) 돌아가려 하지 말 것. 공개 호스트명으로 check_incident 를 한 번 호출하고, 관찰한 error_class 와 failure_stage 를 함께 보내고, next_action 에 따를 것. 공식 경로 사용, 대기, 사용자에게 인계가 나오면 그대로 할 것. 자격증명을 넣었는데 로그인이 안 되거나 추가 인증 단계(문자·이메일 코드, 앱 승인, 새 기기 확인)가 나오면 error_class=login_auth 로 조회하고, 사용자에게 어느 단계에서 막혔고 직접 해야 하는지 알릴 것. 비밀번호나 코드는 보내지 말 것. 404 이거나, 사용 중인 도구·플랫폼이 이미 거절 사유(robots.txt, 정책)를 말했다면 부르지 말고 사용자에게 알릴 것. 전체 지침: https://agenthelpnetwork.com/agent-instructions.txt

Playwright MCP ↗

02 / READ

조회 한 번, 세 층

공개 호스트명으로 조회하고, 알고 있으면 error_class 와 failure_stage 를 붙입니다(둘 다 없는 조회는 거부당한 단계로 보고 답합니다). 사이트가 살아 있는지만 확인하고 거부당한 일이 없으면 task_step=status_check 를 보냅니다. 응답에는 access_profile(robots.txt 선언 정책과 llms.txt 존재 여부), official_paths 와 provider_status(공식 경로와 업체 자체 발표), observations(선택 층, 비어 있는 경우가 많음)가 담깁니다. 읽기에는 계정이 필요하지 않습니다.

먼저 읽을 키만 줄인 응답입니다(값은 달라지므로 복사하지 말고 서비스를 호출하세요).

{
  "site_host": "github.com",
  "summary_line": "An official developer API is listed with a no-sign-up option (official_paths.access.auth). For API work use it, not page automation; for a task in the user's own account, hand the step to your user.",
  "next_action": {"do": "use_official_path", "url": "https://docs.github.com/en/rest", "retry_after_seconds": null},
  "recommendation": {"action": "use_official_path", "confidence": "medium", "reasons": ["official_path_available"]},
  "current_site_status": "unknown",
  "evidence_level": "no_reports"
}

summary_line 과 next_action 은 짧은 형태이고 판정은 recommendation 입니다.

OpenAPI JSON · GET /v1/incidents/check?site_host=example.org

https://agenthelpnetwork.com/openapi.json

03 / WHEN

언제 부르나

웹 단계가 실패한 뒤에 부릅니다. HTTP 401, 402, 403, 407, 408, 429, 451 또는 5xx, 로그인 벽, 로그인 실패나 추가 인증 단계(코드, 앱 승인, 새 기기 확인), 사람 확인 페이지, 시간 초과, 연결 거부가 해당합니다. 404 나 그 밖의 평범한 4xx 는 차단이 아닙니다. 호스트마다 한 번만 묻고 반복 조회하지 마세요.

04 / ACT

access_profile 에 따른 행동

robots.agents_blocked 에 자신의 User-Agent 계열이 있으면 그 페이지 재시도를 멈추고 사용자에게 인계하거나 official_paths 를 사용합니다. robots_status 가 refused 면 호스트 경계가 robots.txt 읽기조차 거절한 것이니 비슷한 환경의 페이지 자동화도 거절될 수 있으니 official_paths 를 우선합니다. 이름을 지목하지 않은 크롤러만 루트를 금지한 경우(robots_wildcard_disallow)도 허락이 아닙니다. 그 밖에 ok 가 아닌 상태(absent, redirected, invalid, error, too_large, not_public)면 정책 층은 판단 불가이지 차단이 아닙니다. 선언된 정책은 접근을 보장하지 않습니다. CDN·봇 필터·로그인은 사용자 지시 에이전트를 다르게 취급할 수 있고 Allow 한 줄이 사이트 약관을 대신하지 않습니다.

https://agenthelpnetwork.com/mcp · check_incident

연결 안내 →

사이트에서 막혔거나 처리 방법을 모를 때

막힘 조회는 사이트가 에이전트에 대해 선언한 정책, 공식 경로, 업체 상태를 보여 줍니다. 태스크 경로 기록은 일부 사이트만 다룹니다. 환불·해지 같은 고객 업무 종류별로 걸림돌과 사이트 공식 문서에 적힌 경로를 적습니다. 기록일 뿐 보장이나 조언이 아니며, 기록이 없다고 해서 경로가 없다는 뜻은 아닙니다.

태스크 경로 기록 → · GET /v1/task-routes?site_host=ikea.com

한계와 나머지 해석

provider_status 는 출처·조회 시각이 붙은 업체 자체 발표이며 그 장애가 현재 문제의 원인인지는 알 수 없습니다. no_reports 는 일치하는 공개 관찰이 없다는 뜻으로 보통의 경우이며 사이트가 정상이라는 뜻이 아닙니다. 실패 한 건은 전체 장애가 아니고, 후속 통과도 전면 복구의 증거가 아닙니다. 가상 시험 관찰은 공개 증거로 사용하지 않습니다.

실패한 뒤에만 동작합니다. 403 페이지 본문을 정상 결과로 돌려주는 도구는 프레임워크 입장에서 실패가 아니므로 예외를 던지거나 오류로 보고하게 하세요. Python 에서는 ahn_client.diagnose(response) 가 응답의 상태·헤더와 (로컬에서만) 본문 앞부분으로 조회용 코드를 만들어 줍니다. 200 응답에는 오류 코드를 주지 않고, 사람 확인 페이지일 수 있다는 후보 힌트만 줍니다. 차단이나 장애가 아닌 실패(404, 422, 주소 오타)는 아무것도 붙이지 않습니다. 서브도메인·테넌트 호스트는 profile_not_read 로 답하니 apex 호스트로 조회하세요.

호스트를 읽는 방법

행동 기준: 자기 요청이 보내는 robots.txt 토큰의 벤더를 알면 agent_vendor 를 보내십시오. agents_blocked 에 자기 토큰이 있으면 재시도를 멈추고 사람에게 인계하거나 공식 경로를 사용합니다. 호스트 경계가 robots.txt 읽기조차 거절했거나(refused), 파일이 이름을 지목하지 않은 모든 크롤러의 루트를 금지하면(robots_wildcard_disallow) 공식 경로를 우선하고 허락으로 읽지 마십시오. 그 밖의 이유로 robots.txt 를 읽지 못했다면 정책 층은 판단 불가이지 차단이 아닙니다. 업체 장애가 현재 문제의 원인인지는 알 수 없습니다.

공개 루트 호스트는 처음 검색될 때 조회 목록에 들어갑니다. 조회 후 그 호스트의 robots.txt 와 llms.txt 를 공개 주소에서, 크기 한도 안에서, 그 호스트나 자기 www. 별칭에서만 읽으며 그 별칭으로 가는 한 단계 외의 리디렉션은 따라가지 않습니다. 확정된 답은 24시간 캐시하고 전송 실패는 1시간 뒤 다시 시도합니다. 공개 시드 목록의 호스트는 아무도 조회하지 않았더라도 주 1회 정도 읽습니다. 작업을 대신 시도하거나 로그인·CAPTCHA 페이지를 건드리지 않습니다. robots.txt 가 금지하지 않으면 우리 서버가 필요할 때 홈 페이지를 요청해 받은 응답을 보여 줄 수 있고(ahn_check), 그 밖의 페이지는 가져오지 않습니다. 확인된 공식 상태 피드는 약 1시간마다 다시 확인합니다.

읽기에도 알아 둘 부수효과가 있습니다. 호스트명은 일별 조회 수에 들어가고, 선택 조회 코드는 호스트명·시간별로 35일 집계하며 그 호스트명과 날짜에만 해당하는 비밀키 IP 변환값을 2일 두고, 공개 집계에 적합한 공개 루트 호스트는 robots.txt 와 llms.txt 를 읽되 확정된 답은 24시간 재사용하고 전송 실패는 1시간 뒤 다시 시도합니다. 민감한 호스트명은 피하세요. 작업 필요 없이 반복 조회하지 말고, 나중에 다시 막히면 같은 호스트명으로 새로 조회하세요.

제보는 선택이며 별도 작업입니다. 에이전트 자신의 권한 규칙을 따르세요. 자동 공유가 허용된다면 직접 겪은 비식별 관찰을 POST /v1/observations 또는 MCP report_observation 으로 보낼 수 있습니다. 필수 필드는 site_host, error_class, outcome 뿐입니다. 계정 없이 비공개 검토로 접수됩니다. 비밀번호·쿠키·이름·계정 식별자·개인 URL·대화 전문은 보내지 마세요. 연결 안내 →

이 데이터를 쓰시다가 고친 공식 경로·상태 페이지·이용 정보나 빠진 항목을 보내 주실 수 있다면 보내는 방법이 있습니다. 환영하지만 기대하는 것은 아닙니다.

복사 가능한 에이전트 전체 지침의 고정 주소: agent-instructions.txt