Standardize README.md structure and improve documentation

[oscarvalenzuelab]

Summary

• Implement standardized README structure following PyPI and OSS best practices
• Add comprehensive badges for better project visibility and trust
• Restructure content with clear hierarchy and improved navigation
• Enhance SEMCL.ONE ecosystem integration documentation

Changes Made

Structure Improvements

• Added professional badge row (License, Python version, PyPI)
• Reorganized sections with consistent hierarchy
• Improved Quick Start section for immediate user value
• Enhanced CLI and API usage examples with better organization

Content Enhancements

• Expanded project description with clear value proposition
• Added dedicated SEMCL.ONE ecosystem integration section
• Improved documentation, contributing, and support sections
• Enhanced Python API examples with batch processing
• Maintained all existing functionality while improving readability

Documentation Standards

• Follows PyPI packaging documentation best practices
• Implements consistent structure across SEMCL.ONE ecosystem
• Improves discoverability and professional appearance
• Enhanced navigation and user experience

Test Plan

• Verify all existing links remain functional
• Ensure badge URLs resolve correctly
• Confirm markdown formatting renders properly
• Validate content accuracy and completeness
• Test installation instructions remain current
• Verify all CLI examples are accurate

Benefits

• Improved professional appearance and trust indicators
• Better discoverability through standardized structure
• Enhanced user onboarding experience
• Consistent documentation across SEMCL.ONE ecosystem
• PyPI compatibility and best practice compliance
• Clear integration patterns with other ecosystem tools