IntentLink: The Active Web for AI Agents

"Static Hyperlinks connect pages; IntentLink connects purposes via link.json."

This project introduces a new paradigm for autonomous service discovery and integration in the age of AI agents. It moves beyond manual API plumbing toward a self-evolving web ecosystem.

🤖 Universal Compatibility

IntentLink is designed to be Agent-Agnostic.

• Protocols: Works with any LLM capable of understanding JSON schemas (GPT-4, Claude 3, Gemini 1.5).
• Skills: The link-extractor skill follows a standard markdown structure usable by OpenClaw, LangChain, and AutoGPT.
• CLI: The intentlink CLI is a standalone Node.js tool that integrates with any agent's tool execution environment.

📦 Installation (CLI Tool)

Install the universal CLI tool to manage the autonomous web from your terminal.

npm install -g intentlink-cli

Run intentlink --help to get started.

💻 CLI Usage

Once installed, use the intentlink command to manage the autonomous web.

1. Harvest Services

Crawl an 'Awesome List' or any markdown file to discover and index services.

intentlink harvest https://github.com/public-apis/public-apis
# Output: Found 150 services. Indexing to local registry...

2. Match Intents

Find the best services for your needs using the vector-based broker.

intentlink match "I need to ship a package and check the weather"
# Output:
# 🏆 Top Recommendations:
# 1. flash-ship (Score: 0.92) - Logistics & Shipping
# 2. openweather-api (Score: 0.88) - Weather Data

3. Run Integration

Execute a connection proposal generated by the broker.

intentlink run ./proposal.json
# Output: Generating Node.js code... Executing bridge... Success!

📦 Installation (AI Skills)

Empower your agent with IntentLink capabilities.

1. Link Extractor

Parses web content into link.json.

• Download link-extractor-v1.0.1.skill

2. IntentLink Broker

Intelligent matching and connection proposals.

• Download intentlink-broker-v1.0.0.skill

🚀 Key Concepts

1. IntentLink Protocol: A lightweight, intent-based framework centered around link.json that describes a service's Purpose and Capabilities.
2. IntentLink Extractor (Skill): A specialized AI skill that analyzes legacy web documentation and automatically generates link.json "Digital Twins."
3. IntentLink Broker: An intelligent intermediary that reasons about service goals to propose non-obvious, high-value connections.

🏆 Proven Success (IntentLink v0.2.0 Milestones)

• Autonomous Extraction: Successfully converted the OpenWeatherMap API using the IntentLink Extractor.
• Semantic Matching: Connected 'Bookstore' to 'GitHub' using the IntentLink Broker.
• Cross-AI Interoperability: Verified across Gemini & Codex with the IntentLink specifications.

🗺️ Roadmap: The Journey to v1.0

• [NEXT] v0.8: IntentLink Connector (Auto-Code Generation) - Generating integration code based on Connection Proposals.
• [PLANNED] v0.9: IntentLink Observer & Multi-Modal - Support for ui-web, deep-link, and real-time health monitoring.

📚 Standards & Best Practices

• ARCHITECTURE.md: System overview and component map.
• INTENTLINK_PROTOCOL.md: The core definition.
• SCHEMA.json: The formal JSON Schema.
• BEST_PRACTICES.md: Guidelines for discovery and security.
• AI_BROKER_SPEC.md: The behavioral contract for AI brokers.

Created with IntentLink - Connecting Intentions, Not Just URLs.