Scholarly Providers Documentation

Build reliable scholarly features without juggling raw HTTP for OpenAlex, Semantic Scholar (S2), and Crossref. This package unifies provider contracts, normalizes payloads, adds retries + caching, and exports rich graphs ready for analysis or visualization.

🚀 Getting Started

Getting Started - Quick wins and why not raw HTTP
Installation & First Steps - Get up and running in minutes

📖 Core Documentation

Contracts Reference - Query, Paginator, ScholarlyDataSource APIs
Architecture Overview - System design and component relationships
Graphs & Algorithms - Citation/collaboration graphs + exporters

🔌 Provider Integrations

Provider Capabilities - Common behaviors across adapters
Adapters Documentation - OpenAlex, S2, Crossref specifics

⚡ Advanced Features

Extending - Build your own adapter and add features
Laravel Integration - Framework integration, config, and facade

Learning Path

New to the package? Follow this recommended sequence:

Start with Getting Started for immediate wins
Review Contracts Reference to understand the API surface
Explore Graph Capabilities for advanced analytics
Check Provider-Specific Guides for implementation details

External Resources

GitHub Repository - Source code and issues
Packagist - Composer package
mbsoft31/graph-core - Graph data structures
mbsoft31/graph-algorithms - Graph analysis tools

Core Concepts: Contracts	Architecture	Getting Started
Features: Graph Analytics	Laravel Integration	Provider Adapters
Development: Extending	GitHub Repository

External Resources: OpenAlex API

Semantic Scholar API

Crossref API