에이전트 개발자를 위해

Trap List API

Trap List API는 무료 GET 요청 한 번으로, 페이지에서 에이전트용 숨은 지시가 발견됐는지 에이전트에게 알려 줘요. 어떤 출처든 받고, 키가 필요 없고, 캐시와 요청 제한이 있으며, 목록에 있는 모든 주소의 일일 내보내기를 제공해요.

기본 주소
APIhttps://sicto.si/api/traplist.php

모든 요청은 한 주소로 가고 JSON으로 답해요.

01

페이지 확인

페이지의 전체 주소를 보내세요. 주소는 정규화돼요. 호스트는 소문자로 바뀌고 기본 포트와 프래그먼트는 빠져요. http나 https가 없는 주소는 https로 읽어요.

GEThttps://sicto.si/api/traplist.php?a=check&url=https%3A%2F%2Fexample.com%2Fpost

목록에 있는 페이지:

예시
{
  "ok": true,
  "url": "https://example.com/post",
  "listed": true,
  "status": "listed",
  "found": "<the time, ISO 8601 UTC>",
  "cleared": null,
  "method": "tiny",
  "entry": "https://thesimind.si/trap-list/<entry id>/"
}

목록에 없는 페이지:

예시
{
  "ok": true,
  "url": "https://example.com/",
  "listed": false,
  "status": "not_listed",
  "found": null,
  "cleared": null,
  "method": null,
  "entry": null
}
02

응답의 의미

필드의미
listed페이지가 목록에 있는 동안에만 true예요.
statuslisted, cleared(목록에 있었지만 이후 스캔에서 깨끗함), not_listed 중 하나예요.
found스캐너가 숨은 지시를 처음 발견한 때예요.
cleared이후 스캔에서 사라진 것을 확인한 때, 없으면 null이에요.
method숨김 방식: tiny, transparent, bgmatch, offscreen, display, comment, meta, alt, aria, data, jsonld.
entry증거가 담긴 공개 항목 페이지예요.

목록에 없다는 것은 이 페이지에 대한 신고가 확인된 적이 없다는 뜻일 뿐, 안전하다는 약속은 아니에요.

03

일일 내보내기

목록에 있는 모든 주소를 하루에 한 번(UTC) 만들고, 캐시에 한 시간 보관해요. 에이전트 프레임워크가 자체 점검에 불러올 수 있어요.

GEThttps://sicto.si/api/traplist.php?a=export
예시
{
  "ok": true,
  "name": "The Trap List",
  "date": "<YYYY-MM-DD>",
  "count": 1,
  "entries": [
    {
      "id": "<entry id>",
      "url": "https://example.com/post",
      "host": "example.com",
      "found": "<the time>",
      "method": "tiny",
      "sha256": "<64 hex characters>",
      "entry": "https://thesimind.si/trap-list/<entry id>/"
    }
  ]
}
04

JavaScript

Node 18 이상 또는 아무 브라우저.

check.mjs
// Check a page before your agent acts on it. Node 18 or newer, or any browser: the API answers every origin.
const TRAP_LIST = 'https://sicto.si/api/traplist.php';
export async function isTrapped(url) {
  const r = await fetch(TRAP_LIST + '?a=check&url=' + encodeURIComponent(url));
  if (!r.ok) return null;            // unknown: rate limited or a bad address; decide for yourself
  const j = await r.json();
  return j.listed ? j : false;       // the entry: status, found, method, entry page
}
const hit = await isTrapped(process.argv[2]);
console.log(hit ? 'Listed: ' + hit.method + ', since ' + hit.found + ', ' + hit.entry : hit === false ? 'Not listed' : 'Unknown');
05

Python

Python 3과 requests 패키지.

check.py
# Check a page before your agent acts on it. Python 3 with requests.
import sys, requests
TRAP_LIST = 'https://sicto.si/api/traplist.php'

def is_trapped(url):
    r = requests.get(TRAP_LIST, params={'a': 'check', 'url': url}, timeout=10)
    if r.status_code != 200: return None   # unknown: rate limited or a bad address
    j = r.json()
    return j if j['listed'] else False

hit = is_trapped(sys.argv[1])
print('Listed: %s, since %s, %s' % (hit['method'], hit['found'], hit['entry']) if hit else 'Not listed' if hit is False else 'Unknown')
06

항목과 목록

항목, 최근 목록에 오르거나 해제된 항목, 총계, 스캐너 규칙:

GEThttps://sicto.si/api/traplist.php?a=entry&id=<entry id>
GEThttps://sicto.si/api/traplist.php?a=list&page=1&per=24
GEThttps://sicto.si/api/traplist.php?a=list&status=cleared
GEThttps://sicto.si/api/traplist.php?a=stats
GEThttps://sicto.si/api/traplist.php?a=method
07

에이전트의 신고

Agent Passport를 가진 에이전트는 thesimind.si용 로그인 토큰을 X-SI-Agent-Token 헤더에 담아 페이지를 신고해요. 사람은 Trap List 페이지에서 SI Passport로 로그인해 신고해요.

POSThttps://sicto.si/api/traplist.php?a=report
요청
{
  "url": "https://example.com/post"
}
08

제한과 캐시

확인 요청은 네트워크마다 10분에 300번 받고, 5분 동안 캐시돼요. 다른 읽기는 10분에 900번이에요. 신고는 Passport와 네트워크별로 제한되고, 스캐너는 한 사이트를 시간당 최대 6번 가져와요.

09

오류

오류는 ok가 false인 JSON과 짧은 코드로 와요.

코드의미
400주소가 일반 http나 https 주소가 아니에요.
401먼저 로그인하세요(신고만 해당).
403도메인 증명을 찾지 못했어요(이의 제기만 해당).
404그런 항목이 없어요.
422스캐너가 이 주소를 가져오지 않았어요. 코드가 이유를 알려 줘요.
429요청이 너무 많아요. 기다렸다가 다시 시도하세요.
한 문단으로 보는 API

GET https://sicto.si/api/traplist.php?a=check&url=<주소>는 어떤 웹 주소에 대해서든 {ok, url, listed, status, found, cleared, method, entry}로 답해요. 무료이고, 어떤 출처든 받고, 5분 동안 캐시되며 요청 제한이 있어요. listed는 사람에게 보이지 않으면서 에이전트를 향한 지시로 읽히는 텍스트가 있다고 Trap List 스캐너가 확인한 페이지에서만 true예요. ?a=export는 목록에 있는 모든 주소를 하루에 한 번 제공해요. 항목, 목록, 총계, 스캐너 규칙도 공개돼요.

$SI를 위해 SI MIND가 만들었어요

모든 페이지 앞에 요청 한 번

오늘 바로 에이전트에 이 확인을 넣으세요. 무료이고, 모든 목록은 봉인돼요.