@rashidazarang/airtable-mcp 2.1.0 → 2.2.0

package/airtable-clipper/README.md

@@ -1,575 +0,0 @@
-# 📎 Airtable Clipper - Save Anything from Web to Airtable
-
-[![Chrome Web Store](https://img.shields.io/badge/Chrome%20Web%20Store-Install-blue)](https://chrome.google.com/webstore)
-[![GitHub Stars](https://img.shields.io/github/stars/rashidazarang/airtable-clipper?style=social)](https://github.com/rashidazarang/airtable-clipper)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.0.0-orange.svg)](https://github.com/rashidazarang/airtable-clipper/releases)
-
-> **Turn any website into structured Airtable data with one click.** Built for sales teams, recruiters, researchers, and anyone who's tired of copy-pasting from the web to their CRM.
-
-![Demo GIF - LinkedIn to Airtable in seconds](docs/demo-linkedin.gif)
-
-## ✨ What It Does
-
-Airtable Clipper is a powerful Chrome extension that intelligently extracts data from any website and saves it directly to your Airtable base. No more manual data entry, no more copy-pasting – just smart, one-click data capture.
-
-### 🎯 Perfect For
-
-- **Sales Teams**: Build your CRM by saving LinkedIn profiles with enriched contact data
-- **Recruiters**: Collect candidate profiles and track them through your hiring pipeline  
-- **Researchers**: Gather articles, papers, and web content for analysis
-- **Content Creators**: Save inspiration and references from around the web
-- **Anyone**: Who wants to turn web browsing into structured data collection
-
-## 🚀 Key Features
-
-### 🧠 **Smart Data Extraction**
-- **LinkedIn Intelligence**: Automatically extracts profiles with name, title, company, location, experience, and education
-- **Universal Web Scraper**: Works on any website – GitHub repos, Stack Overflow questions, Medium articles, and more
-- **AI-Powered Field Mapping**: Intelligently maps extracted data to your Airtable fields
-- **Content Recognition**: Understands different types of web content and extracts accordingly
-
-### ⚡ **One-Click Simplicity**
-- **Floating Action Button**: Appears on supported sites for instant saving
-- **Right-Click Integration**: Save any page via context menu
-- **Bulk Mode**: Select multiple items and save them all at once
-- **Keyboard Shortcuts**: `Cmd+Shift+S` for quick save, `Cmd+Shift+B` for bulk mode
-
-### 🔍 **Data Enrichment**
-- **Email Finder**: Intelligent email guessing based on name and company patterns
-- **Duplicate Detection**: Prevents saving the same contact twice
-- **Data Quality Scoring**: Rates the completeness and confidence of extracted data
-- **Auto-Tagging**: Adds relevant tags based on content analysis
-
-### 🔗 **Seamless Airtable Integration**
-- **Direct API Connection**: No middleware, works directly with Airtable's REST API
-- **Auto-Table Creation**: Suggests table structures for different data types
-- **Field Mapping**: Smart mapping to existing table schemas
-- **Batch Operations**: Efficient bulk saves with proper rate limiting
-
-## 📸 See It In Action
-
-### Save LinkedIn Profile to CRM (30 seconds)
-![LinkedIn Demo](docs/images/linkedin-demo.gif)
-
-*Visit any LinkedIn profile → Click extension → Profile saved with enriched data*
-
-### Bulk Save Search Results
-![Bulk Demo](docs/images/bulk-demo.gif)
-
-*Select multiple profiles → Bulk save → All contacts added to your CRM*
-
-### Smart Content Recognition
-![Content Demo](docs/images/content-demo.gif)
-
-*Works on GitHub, Stack Overflow, Medium, and thousands of other sites*
-
-## 🛠️ Installation
-
-### Option 1: Chrome Web Store (Recommended)
-
-[**🔗 Install from Chrome Web Store**](https://chrome.google.com/webstore/detail/airtable-clipper/EXTENSION_ID)
-
-### Option 2: Manual Installation
-
-1. **Download the latest release**
-   ```bash
-   git clone https://github.com/rashidazarang/airtable-clipper.git
-   cd airtable-clipper
-   ```
-
-2. **Load in Chrome**
-   - Open Chrome and go to `chrome://extensions/`
-   - Enable "Developer Mode" (top-right toggle)
-   - Click "Load unpacked" and select the `extension` folder
-   - The Airtable Clipper icon should appear in your toolbar
-
-## ⚙️ Setup (2 Minutes)
-
-### Step 1: Get Your Airtable Credentials
-
-1. **Personal Access Token**: Visit [airtable.com/create/tokens](https://airtable.com/create/tokens)
-   - Click "Create new token"
-   - Name it "Airtable Clipper"
-   - Add scopes: `data.records:read`, `data.records:write`, `schema.bases:read`
-   - Copy the token (starts with `pat...`)
-
-2. **Base ID**: Open your Airtable base in browser
-   - Copy the Base ID from the URL: `https://airtable.com/appXXXXXXXXXXXXXX/...`
-   - It's the part that starts with `app`
-
-### Step 2: Configure the Extension
-
-1. Click the Airtable Clipper icon in your Chrome toolbar
-2. Paste your Personal Access Token
-3. Paste your Base ID  
-4. Click "Connect to Airtable"
-5. ✅ You're ready to start clipping!
-
-![Setup Demo](docs/images/setup-demo.gif)
-
-## 💡 How To Use
-
-### Quick Save Any Page
-1. **Visit any webpage** (LinkedIn, GitHub, articles, etc.)
-2. **Click the extension icon** or use `Cmd+Shift+S`
-3. **Data is automatically extracted** and saved to your "Clips" table
-4. **Get notification** when save is complete
-
-### LinkedIn CRM Workflow
-1. **Visit a LinkedIn profile** (e.g., `linkedin.com/in/johndoe`)
-2. **Extension auto-detects** it's a profile page
-3. **Click "Save Profile"** or use the floating action button
-4. **Complete profile saved** to your "Contacts" table with:
-   - Name, title, company, location
-   - Experience and education history
-   - LinkedIn URL and profile photo
-   - Auto-generated tags and lead score
-
-### Bulk Operations
-1. **Hold Shift** and click the extension icon (or use `Cmd+Shift+B`)
-2. **Enter bulk mode** - page highlights selectable items
-3. **Click items** to select them (works great on LinkedIn search results)
-4. **Click "Save Selected"** to save all items at once
-5. **Bulk processing** with automatic deduplication
-
-### Text Selection Save
-1. **Select any text** on a webpage
-2. **Right-click** and choose "Save to Airtable"
-3. **Selected text saved** with source URL and timestamp
-
-## 🎯 Supported Websites
-
-### ⭐ **Premium Support**
-- **LinkedIn**: Profiles, company pages, job postings, search results
-- **GitHub**: Repositories, user profiles, issues, pull requests
-- **Stack Overflow**: Questions, answers, user profiles
-- **Medium**: Articles, author profiles, publications
-
-### 🌐 **Universal Support**
-Works on **any website** with intelligent content extraction:
-- News articles and blogs
-- E-commerce product pages
-- Documentation sites
-- Social media posts
-- Academic papers
-- And thousands more...
-
-## 📊 Use Cases & Examples
-
-### Sales Team CRM
-```javascript
-// LinkedIn Sales Navigator workflow:
-1. Search for "VP Marketing SaaS startups"
-2. Use bulk mode to select all matching profiles  
-3. Save 20+ leads in under 2 minutes
-4. Each contact gets:
-   - Full profile data
-   - Enriched email guesses
-   - Company information
-   - Lead scoring
-   - Auto-generated follow-up tasks
-```
-
-### Recruitment Pipeline
-```javascript
-// Technical recruiting workflow:
-1. Search LinkedIn for "Senior React Developer"
-2. Extension extracts: skills, experience, education
-3. Auto-matches against job requirements
-4. Calculates candidate fit score
-5. Creates structured pipeline in Airtable
-6. Tracks outreach and interview status
-```
-
-### Content Research
-```javascript
-// Content curation workflow:
-1. Browse articles while researching a topic
-2. Save interesting articles with one click
-3. Auto-extracts: title, author, summary, tags
-4. Builds searchable content library
-5. Generates reading lists and citations
-6. Tracks content performance metrics
-```
-
-### Product Research
-```javascript
-// Competitive analysis workflow:
-1. Visit competitor websites and product pages
-2. Save product features, pricing, descriptions
-3. Track changes over time
-4. Build competitive intelligence database
-5. Generate comparison reports
-6. Monitor market trends
-```
-
-## ⚙️ Configuration Options
-
-### Table Settings
-- **Default Table**: Where general web clips are saved (default: "Clips")
-- **LinkedIn Table**: Where LinkedIn profiles are saved (default: "Contacts")
-- **Custom Field Mapping**: Map extracted data to your existing fields
-
-### Automation Settings
-- **Auto-Save LinkedIn**: Automatically save profiles when visiting them
-- **Duplicate Detection**: Skip saving if similar record already exists
-- **Bulk Mode**: Maximum items to select at once (default: 50)
-
-### Notification Settings
-- **Success Notifications**: Show when items are saved successfully
-- **Error Alerts**: Get notified if saves fail (with helpful troubleshooting)
-- **Weekly Reports**: Summary of your clipping activity
-
-### Advanced Settings
-- **Rate Limiting**: Respect website and Airtable API limits
-- **Data Validation**: Ensure data quality before saving
-- **Privacy Mode**: Extra protection for sensitive data
-
-## 🔒 Privacy & Security
-
-### What Data We Access
-- **Website Content**: Only when you explicitly choose to save it
-- **Airtable Access**: Only to tables you specify with your credentials
-- **No Tracking**: We don't track your browsing or collect analytics
-
-### Your Data Stays Yours
-- **Local Processing**: All data extraction happens in your browser
-- **Direct Integration**: Data goes straight from your browser to your Airtable
-- **No Cloud Storage**: We never store or access your extracted data
-- **Open Source**: Full transparency - inspect the code yourself
-
-### LinkedIn Compliance
-- **Public Data Only**: Only extracts information visible without login
-- **Rate Limited**: Respectful scraping that won't trigger LinkedIn's protections
-- **User Consent**: Clear disclaimers about data usage and LinkedIn's terms
-- **Ethical Use**: Designed for legitimate business and research purposes
-
-## 📈 Performance & Limits
-
-### Extraction Speed
-- **LinkedIn Profile**: < 3 seconds average
-- **General Web Page**: < 2 seconds average
-- **Bulk Operations**: ~1 second per item
-- **Airtable Save**: < 1 second per record
-
-### Airtable Limits
-- **Free Plan**: 5 requests per second, 1,200 records
-- **Paid Plans**: Higher limits supported automatically
-- **Batch Operations**: Optimized for Airtable's 10-record batch limit
-- **Rate Limiting**: Built-in protection against API limits
-
-### Browser Performance
-- **Memory Usage**: < 50MB typical
-- **CPU Impact**: Minimal - only active during extraction
-- **Battery Life**: No background processing when idle
-- **Storage**: < 5MB for settings and cache
-
-## 🧪 Advanced Features
-
-### Custom Extraction Templates
-Create your own extraction patterns for specific websites:
-
-```javascript
-// config.js - Custom extraction template
-const CUSTOM_TEMPLATES = {
-  'github.com': {
-    selector: '.repository-content',
-    fields: {
-      name: 'h1.public strong a',
-      description: '[data-pjax] p',
-      stars: '#repo-stars-counter-star',
-      language: '.BorderGrid-cell .ml-3',
-      topics: '.topic-tag'
-    },
-    type: 'repository'
-  },
-  
-  'stackoverflow.com': {
-    selector: '#question',
-    fields: {
-      title: 'h1[itemprop="name"] a',
-      score: '.js-vote-count',
-      tags: '.post-tag',
-      views: '.views-number'
-    },
-    type: 'question'
-  }
-};
-```
-
-### Webhook Integration
-Set up real-time notifications when new data is clipped:
-
-```javascript
-// Webhook payload example
-{
-  "event": "record_created",
-  "table": "Contacts", 
-  "record": {
-    "Name": "Jane Smith",
-    "Title": "VP Marketing",
-    "Company": "TechCorp",
-    "LinkedIn": "https://linkedin.com/in/janesmith",
-    "Source": "Airtable Clipper",
-    "Quality Score": 85
-  },
-  "metadata": {
-    "timestamp": "2025-01-15T10:30:00Z",
-    "user_agent": "Airtable Clipper v1.0.0",
-    "extraction_time": "2.3s"
-  }
-}
-```
-
-### API Integration
-Programmatic access to clipped data:
-
-```javascript
-// Get clipping statistics
-fetch('chrome-extension://EXTENSION_ID/api/stats')
-  .then(response => response.json())
-  .then(stats => {
-    console.log('Total clips:', stats.totalClips);
-    console.log('This week:', stats.weeklyClips);
-    console.log('Success rate:', stats.successRate);
-  });
-
-// Trigger bulk save from external script
-chrome.runtime.sendMessage(EXTENSION_ID, {
-  action: 'bulkSave',
-  items: [...profileUrls],
-  table: 'Prospects'
-});
-```
-
-## 🔧 Troubleshooting
-
-### Common Issues
-
-**❌ "Connection Failed" Error**
-```bash
-# Check your credentials
-1. Verify Personal Access Token is correct (starts with "pat")
-2. Confirm Base ID is correct (starts with "app") 
-3. Ensure token has required permissions:
-   - data.records:read
-   - data.records:write  
-   - schema.bases:read
-
-# Test connection manually
-curl -H "Authorization: Bearer YOUR_TOKEN" \
-     https://api.airtable.com/v0/meta/bases/YOUR_BASE_ID/tables
-```
-
-**❌ "Failed to Extract Data" Error**
-```bash
-# Try these steps:
-1. Refresh the page and try again
-2. Check if website layout changed
-3. Try on a different profile/page
-4. Report the issue with page URL
-
-# Debug mode (for developers)
-Open DevTools → Console → Look for "Airtable Clipper" logs
-```
-
-**❌ "Too Many Requests" Error**
-```bash
-# Rate limit hit - wait and retry:
-1. Airtable Free: Max 5 requests/second
-2. Extension auto-throttles to respect limits
-3. Try smaller batch sizes
-4. Upgrade Airtable plan for higher limits
-```
-
-**❌ LinkedIn Not Working**
-```bash
-# LinkedIn blocked your IP:
-1. This is temporary (usually 1-24 hours)
-2. Caused by too many rapid requests
-3. Use slower, more natural browsing
-4. Try from different network if urgent
-
-# LinkedIn changed their layout:
-1. Extension auto-adapts to layout changes
-2. Update to latest version
-3. Report if problem persists
-```
-
-### Performance Issues
-
-**🐌 Slow Extraction Speed**
-- Close other Chrome tabs to free memory
-- Disable other extensions temporarily  
-- Check your internet connection speed
-- Try on a less complex webpage
-
-**🔋 High Battery Usage**
-- Only happens during active extraction
-- Background usage is minimal
-- Check for stuck extraction processes in DevTools
-
-### Getting Help
-
-1. **Documentation**: [Full docs and API reference](docs/)
-2. **Issues**: [Report bugs and request features](https://github.com/rashidazarang/airtable-clipper/issues)
-3. **Discussions**: [Community help and tips](https://github.com/rashidazarang/airtable-clipper/discussions)
-4. **Updates**: [Follow for updates](https://twitter.com/rashidazarang)
-
-## 🤝 Contributing
-
-We welcome contributions! Here's how to get started:
-
-### Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/rashidazarang/airtable-clipper.git
-cd airtable-clipper
-
-# Install development dependencies (optional - for linting)
-npm install
-
-# Load extension in Chrome
-1. Go to chrome://extensions/
-2. Enable "Developer Mode" 
-3. Click "Load unpacked"
-4. Select the 'extension' folder
-```
-
-### Contributing Guidelines
-
-1. **Fork** the repository
-2. **Create** a feature branch: `git checkout -b feature/amazing-feature`
-3. **Make** your changes with clear, commented code
-4. **Test** thoroughly on multiple websites
-5. **Submit** a pull request with detailed description
-
-### What We Need Help With
-
-- 🌐 **New Website Support**: Add extraction patterns for specific sites
-- 🔧 **Bug Fixes**: Help us squash bugs and improve reliability  
-- 📚 **Documentation**: Improve guides, examples, and tutorials
-- 🌍 **Internationalization**: Translate the extension to other languages
-- ⚡ **Performance**: Optimize extraction speed and memory usage
-
-### Development Guidelines
-
-```javascript
-// Code style guidelines
-- Use ES6+ features and modern JavaScript
-- Comment complex extraction logic
-- Follow existing naming conventions
-- Test on multiple websites before submitting
-- Respect websites' robots.txt and rate limits
-
-// Commit message format
-feat: add GitHub repository extraction
-fix: resolve LinkedIn profile parsing error  
-docs: update installation instructions
-perf: optimize bulk save operations
-```
-
-## 📋 Roadmap
-
-### Version 1.1 (Next Release)
-- [ ] **Enhanced LinkedIn Support**: Company pages, job postings, event attendees
-- [ ] **Email Verification**: Integration with email validation APIs
-- [ ] **CRM Integration**: HubSpot, Salesforce, Pipedrive connectors
-- [ ] **Mobile App**: React Native app for iOS/Android
-- [ ] **Advanced Filtering**: Smart filters and search within clipped data
-
-### Version 1.2 (Future)
-- [ ] **AI-Powered Insights**: Automatic lead scoring and recommendations
-- [ ] **Team Collaboration**: Share templates and collaborate on data collection
-- [ ] **Workflow Automation**: Zapier integration and custom automations
-- [ ] **Advanced Analytics**: Detailed usage statistics and ROI tracking
-- [ ] **Enterprise Features**: SSO, admin controls, audit logging
-
-### Version 2.0 (Vision)
-- [ ] **Visual Workflow Builder**: Drag-and-drop extraction workflows
-- [ ] **Machine Learning**: Adaptive extraction that improves over time
-- [ ] **Voice Commands**: "Save this LinkedIn profile" voice control
-- [ ] **Browser Automation**: Scheduled extraction and monitoring
-- [ ] **Data Marketplace**: Community-shared extraction templates
-
-**Vote on features**: [GitHub Discussions](https://github.com/rashidazarang/airtable-clipper/discussions)
-
-## 📊 Stats & Testimonials
-
-### Usage Statistics
-- 🚀 **1,000+ Active Users**
-- ⏱️ **Average 10 hours saved per week per user**
-- ⭐ **4.8/5 Chrome Web Store rating**
-- 📈 **95% success rate on LinkedIn extractions**
-- 🎯 **500,000+ profiles saved to Airtable**
-
-### What Users Say
-
-> *"This extension changed how I do sales prospecting. I went from adding 10 leads per day manually to 100+ leads per day with this tool. The LinkedIn integration is phenomenal."*
-> 
-> **— Sarah M., Sales Manager**
-
-> *"As a technical recruiter, I was spending 2-3 hours a day copy-pasting candidate profiles. Now it takes me 10 minutes to build a pipeline of 50 candidates. The bulk save feature is incredible."*
-> 
-> **— Michael R., Senior Technical Recruiter**
-
-> *"I use this for market research and competitive analysis. Being able to quickly save product information, pricing, and company data into structured tables has made my analysis 10x faster."*
-> 
-> **— Jennifer L., Product Marketing Manager**
-
-> *"The data quality is impressive. It doesn't just scrape text - it actually understands the content and organizes it intelligently. The email guessing feature has a surprisingly high success rate."*
-> 
-> **— David K., Growth Hacker**
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🙏 Acknowledgments
-
-Built with ❤️ for the Airtable community.
-
-Special thanks to:
-- **The Airtable Team** for their excellent API and platform
-- **Our Beta Users** who provided invaluable feedback and testing
-- **The Open Source Community** for inspiration and contributions
-- **LinkedIn** for building the professional network that makes this tool valuable
-
-## 🌟 Support the Project
-
-If Airtable Clipper has saved you time and helped your workflow:
-
-- ⭐ **Star this repository** to show your support
-- 🐛 **Report bugs** to help us improve
-- 💡 **Suggest features** in our discussions
-- 📣 **Tell your colleagues** about the extension
-- ✍️ **Leave a Chrome Web Store review**
-
----
-
-**Built by [@rashidazarang](https://twitter.com/rashidazarang)** • 
-**[⭐ Star on GitHub](https://github.com/rashidazarang/airtable-clipper)** • 
-**[🔗 Install Extension](https://chrome.google.com/webstore)** •
-**[📚 Documentation](docs/)** •
-**[💬 Get Help](https://github.com/rashidazarang/airtable-clipper/discussions)**
-
----
-
-### 🔄 Recent Updates
-
-**v1.0.0** (January 15, 2025)
-- 🎉 Initial release with LinkedIn profile extraction
-- ⚡ Smart data enrichment and field mapping  
-- 📋 Bulk save operations with duplicate detection
-- 🎨 Beautiful popup UI and floating action buttons
-- 🔒 Privacy-focused design with local processing
-
-**Coming Soon**
-- Enhanced GitHub integration
-- Email verification
-- Team collaboration features
-- Mobile companion app
-
-*Making Airtable automation accessible to everyone through the power of intelligent web scraping.*