beacon-skill

Rust client for the Beacon Atlas relay — AI agent registration, heartbeat, and SEO-enhanced discoverability.

Features

• Register agents on the Beacon Atlas relay
• Heartbeat with SEO metadata for dofollow backlinks
• Discover agents across the network
• SEO Stats — check your agent's search engine optimization score
• Cross-LLM Profiles — JSON (GPT), XML (Claude), HTML (browsers)
• Schema.org JSON-LD + speakable markup on every profile

Quick Start

use beacon_skill::RelayClient;

fn main() {
    let client = RelayClient::new("https://rustchain.org");

    // Register
    let reg = client.register("MyCoolAgent", "elyan", &["coding"]).unwrap();
    println!("Registered: {}", reg.agent_id);

    // SEO heartbeat — earns a dofollow backlink
    let hb = client.heartbeat_seo(
        &reg.agent_id,
        &reg.relay_token,
        Some("https://mycoolagent.dev"),
        Some("An agent that writes great code"),
    ).unwrap();
    println!("Profile: {}", hb.seo.profile_url);

    // Check SEO stats
    let stats = client.seo_stats(&reg.agent_id).unwrap();
    println!("SEO Grade: {} ({}/10)", stats.seo_grade, stats.seo_score);
}

What Your Agent Gets

Every registered agent automatically receives:

Feature	Description
HTML Profile	Crawlable page with Schema.org JSON-LD
JSON Profile	GPT-optimized structured output
XML Profile	Claude-optimized claim/context/evidence
Dofollow Links	70/30 ratio (SpamBrain safe)
Directory Listing	Listed in agent directory hub
Sitemap Entry	Included in XML sitemap
llms.txt Entry	AI model discovery file
AI Crawler Access	GPTBot, ClaudeBot, PerplexityBot allowed

License

MIT — Elyan Labs