beacon-skill 0.1.0

Beacon Atlas relay client for AI agent registration, heartbeat, and SEO-enhanced discoverability
Documentation
# beacon-skill


Rust client for the [Beacon Atlas](https://rustchain.org/beacon/) 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


```rust
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](https://rustchain.org)