{"id":15296452,"url":"https://github.com/aportela/scraper-lyrics","last_synced_at":"2026-03-09T04:02:13.996Z","repository":{"id":197194754,"uuid":"698153711","full_name":"aportela/scraper-lyrics","owner":"aportela","description":"Custom php lyrics scraper","archived":false,"fork":false,"pushed_at":"2025-11-29T23:29:52.000Z","size":158,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-02T04:28:17.545Z","etag":null,"topics":["composer-package","duckduckgo","genius","lyrics","lyricsmania","musicmatch","php","php8","scraper"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aportela.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-09-29T09:23:48.000Z","updated_at":"2025-11-29T23:29:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"7e45dc84-4a42-41eb-b47e-2d478fc31402","html_url":"https://github.com/aportela/scraper-lyrics","commit_stats":null,"previous_names":["aportela/scraper-lyrics"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/aportela/scraper-lyrics","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aportela%2Fscraper-lyrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aportela%2Fscraper-lyrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aportela%2Fscraper-lyrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aportela%2Fscraper-lyrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aportela","download_url":"https://codeload.github.com/aportela/scraper-lyrics/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aportela%2Fscraper-lyrics/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30282541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["composer-package","duckduckgo","genius","lyrics","lyricsmania","musicmatch","php","php8","scraper"],"created_at":"2024-09-30T18:10:33.265Z","updated_at":"2026-03-09T04:02:13.988Z","avatar_url":"https://github.com/aportela.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# scraper-lyrics\n\nCustom php lyrics scraper\n\n## Requirements\n\n- mininum php version 8.4\n\n## Install (composer) dependencies:\n\n```Shell\ncomposer require aportela/scraper-lyrics\n```\n\n## WARNING:\n\nPlease, to prevent source providers from making changes or banning the operation of this scraper, use it reasonably, caching the results in your own storage or database to avoid repeating the same calls. Also, try not to make several calls per second that could be interpreted as a DDOS attack.\n\n## Code example:\n\n```php\n\u003c?php\n\n    require \"vendor/autoload.php\";\n\n    $logger = new \\Psr\\Log\\NullLogger(\"\");\n\n    $cache = null;\n    // uncomment the following lines for storing into disk cache the lyrics\n    //$cachePath = dirname(__FILE__) . DIRECTORY_SEPARATOR . \"cache\";\n    //$cache = new \\aportela\\SimpleFSCache\\Cache($logger, \\aportela\\SimpleFSCache\\CacheFormat::TXT, $cachePath);\n    $lyrics = new \\aportela\\ScraperLyrics\\Lyrics($logger, $cache);\n\n    /**\n    Search/Scrap on all providers\n    */\n    if ($lyrics-\u003escrap(\n        \"Bohemian Rhapsody\",\n        \"Queen\"\n    )) {\n        echo sprintf(\n            \"\u003cH1\u003eTitle: %s\u003c/h1\u003e\u003cH2\u003eArtist: %s\u003c/H2\u003e\u003cH3\u003eSource: %s\u003c/H3\u003e\u003cPRE\u003e%s\u003c/PRE\u003e\",\n            $lyrics-\u003egetTitle(),\n            $lyrics-\u003egetArtist(),\n            $lyrics-\u003egetSource(),\n            $lyrics-\u003egetLyrics()\n        );\n    }\n\n/**\n    Search/Scrap on custom scrap providers\n    You can use this method if at some point in the future a provider stops working and you want to ignore scraping with him (which will give an error) in case you previously used the global (scrap) method\n*/\nif ($lyrics-\u003escrap(\n    \"Bohemian Rhapsody\",\n    \"Queen\",\n    [\n        \\aportela\\ScraperLyrics\\SourceProvider::SEARCH_ENGINE_DUCKDUCKGO,\n        \\aportela\\ScraperLyrics\\SourceProvider::MUSIXMATCH\n    ]\n)) {\n    echo sprintf(\n        \"\u003cH1\u003eTitle: %s\u003c/h1\u003e\u003cH2\u003eArtist: %s\u003c/H2\u003e\u003cH3\u003eSource: %s\u003c/H3\u003e\u003cPRE\u003e%s\u003c/PRE\u003e\",\n        $lyrics-\u003egetTitle(),\n        $lyrics-\u003egetArtist(),\n        $lyrics-\u003egetSource(),\n        $lyrics-\u003egetLyrics()\n    );\n}\n\n/**\n    Search/Scrap on custom source provider\n    Same as the previous one but for a single source provider\n*/\n\nif ($lyrics-\u003escrapFromSourceProvider(\n    \"Bohemian Rhapsody\",\n    \"Queen\",\n    \\aportela\\ScraperLyrics\\SourceProvider::SEARCH_ENGINE_DUCKDUCKGO\n)) {\n    echo sprintf(\n        \"\u003cH1\u003eTitle: %s\u003c/h1\u003e\u003cH2\u003eArtist: %s\u003c/H2\u003e\u003cH3\u003eSource: %s\u003c/H3\u003e\u003cPRE\u003e%s\u003c/PRE\u003e\",\n        $lyrics-\u003egetTitle(),\n        $lyrics-\u003egetArtist(),\n        $lyrics-\u003egetSource(),\n        $lyrics-\u003egetLyrics()\n    );\n}\n```\n\n![PHP Composer](https://github.com/aportela/scraper-lyrics/actions/workflows/php.yml/badge.svg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faportela%2Fscraper-lyrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faportela%2Fscraper-lyrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faportela%2Fscraper-lyrics/lists"}