# Changelog of Competitor Marketing Change Monitor (`happitap/competitor-marketing-change-monitor`) Actor

- **URL**: https://apify.com/happitap/competitor-marketing-change-monitor/changelog.md
- **Full Actor documentation**: https://apify.com/happitap/competitor-marketing-change-monitor.md

## Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

### \[1.0.0] - 2025-12-23

#### Added

- Initial release of Competitor Website Change Tracker
- Playwright-based web scraping with full JavaScript rendering
- Smart content extraction with Mozilla Readability
- Intelligent diff engine with line-by-line comparison
- Noise removal via CSS selectors and regex patterns
- Screenshot capture for visual proof
- Snapshot management with automatic rotation
- Change detection with configurable thresholds
- Highlight detection for pricing, features, and promotions
- Webhook alerts for Slack, Discord, and custom endpoints
- Comprehensive input/output schemas
- Apify platform integration
- Dataset and Key-Value store support
- Scheduled run support
- Complete documentation and examples

#### Features

- **Smart Change Detection**
  - Line-by-line text diffing
  - Configurable change percentage threshold
  - Regex pattern ignoring for timestamps/dates
  - CSS selector-based noise removal

- **Content Extraction**
  - Readability mode for article-like content
  - Selector mode for precise targeting
  - HTML2Text mode for simple conversion
  - Markdown output support

- **Snapshot Management**
  - Automatic current/previous rotation
  - Text and HTML snapshot storage
  - Screenshot storage with PNG format
  - Metadata tracking

- **Alert System**
  - Slack webhook integration with rich formatting
  - Discord webhook integration with embeds
  - Custom webhook support with JSON payload
  - Conditional alerts (only when changed)
  - Screenshot URL inclusion

- **Highlight Detection**
  - Price change detection
  - Feature announcement detection
  - Plan/tier change detection
  - Promotion/discount detection

#### Documentation

- Comprehensive README with examples
- Detailed PRICING guide with cost calculator
- SETUP guide with step-by-step instructions
- Example input files for common use cases
- Input/output schema documentation

#### Examples

- Minimal configuration example
- Pricing monitoring example
- Multi-competitor tracking example
- Discord webhook example

### \[Unreleased]

#### Planned Features

- HTML structural diff comparison
- Screenshot pixel diff comparison
- AI-powered change summarization
- Email alert support
- SMS alert support
- Baseline snapshot management
- Retention policy for old snapshots
- Change history visualization
- API endpoint for programmatic access
- Bulk URL import from CSV
- Custom extraction rules
- Rate limiting and retry logic
- Proxy support for geo-restricted content
- Authentication support (cookies, headers)
- PDF snapshot generation
- Change report PDF export

#### Improvements

- Performance optimization for large-scale monitoring
- Better error handling and recovery
- Enhanced logging and debugging
- Memory usage optimization
- Parallel URL processing
- Incremental snapshot updates

***

### Version History

#### v1.0.0 (2025-12-23)

- Initial public release
- Core functionality complete
- Production-ready

***

### Migration Guides

#### From Manual Monitoring

1. List all competitor URLs you currently track
2. Create input.json with your URLs
3. Configure selectors to target relevant content
4. Set up webhook for alerts
5. Schedule daily runs
6. Review first results and adjust thresholds

#### From Custom Scripts

1. Map your URL list to input schema
2. Migrate selector logic to `selectors.content`
3. Convert ignore rules to `selectors.ignore`
4. Replace diff logic with `diff` configuration
5. Update webhook integration
6. Test and deploy

***

### Support

For questions, issues, or feature requests:

- GitHub Issues: [Create an issue](https://github.com/your-repo/issues)
- Email: support@happitap.com
- Apify Discord: [Join community](https://discord.gg/jyEM2PRvMU)