# 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(
®.agent_id,
®.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(®.agent_id).unwrap();
println!("SEO Grade: {} ({}/10)", stats.seo_grade, stats.seo_score);
}
```
## What Your Agent Gets
Every registered agent automatically receives:
| 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)