{"id":15371104,"url":"https://github.com/jch254/scope-lex-handler","last_synced_at":"2025-04-15T14:03:09.767Z","repository":{"id":74458458,"uuid":"94835436","full_name":"jch254/scope-lex-handler","owner":"jch254","description":"Scope is a Facebook Messenger bot that identifies songs from lyrics/titles","archived":false,"fork":false,"pushed_at":"2020-07-04T07:48:17.000Z","size":207,"stargazers_count":5,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-28T20:51:16.359Z","etag":null,"topics":["aws","bot","facebook-messenger-bot","genius","genius-api","genius-lyrics-search","lambda","lex","messenger-bot","serverless","spotify","spotify-api"],"latest_commit_sha":null,"homepage":"https://m.me/scopebot","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jch254.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-06-20T01:16:18.000Z","updated_at":"2024-06-05T04:36:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"8bfa46a6-ae7c-4277-bcc2-0e231d54e84f","html_url":"https://github.com/jch254/scope-lex-handler","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jch254%2Fscope-lex-handler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jch254%2Fscope-lex-handler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jch254%2Fscope-lex-handler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jch254%2Fscope-lex-handler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jch254","download_url":"https://codeload.github.com/jch254/scope-lex-handler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249085456,"owners_count":21210267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["aws","bot","facebook-messenger-bot","genius","genius-api","genius-lyrics-search","lambda","lex","messenger-bot","serverless","spotify","spotify-api"],"created_at":"2024-10-01T13:45:25.866Z","updated_at":"2025-04-15T14:03:09.721Z","avatar_url":"https://github.com/jch254.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [Scope](https://m.me/scopebot)\n\n[![Scope Vimeo demo](https://img.jch254.com/ScopeVimeo.png)](https://vimeo.com/225540115 \"Scope Vimeo demo - Click to Watch!\")\n\nScope is a Facebook Messenger bot that identifies songs from lyrics/titles. Scope returns detailed information about songs it matches including title, artist, album, release date, recording location, BPM, key, samples, featured artists, producers and writers (where available). Scope also returns direct Spotify, Apple Music, Soundcloud, YouTube and Genius links to the song. Scope is powered by Genius and Spotify APIs so matches are slightly biased towards hiphop and rap music (Genius started off as Rap Genius).\n\nIt's easy to scope a song - just send a message starting with 'scope' followed by the lyric/title you're after (e.g. scope waves). Scope will reply with details of the closest match. If Scope matches the wrong song, simply reply with the word 'wrong' to select from the next best matches.\n\nHit up Scope at [https://m.me/scopebot](https://m.me/scopebot) or [https://facebook.com/scopebot](https://facebook.com/scopebot)\n\n### Technologies Used\n\n- Node.js\n- TypeScript\n- Terraform\n- Lex\n- Lambda\n- CodeBuild\n- Facebook Messenger Platform\n- Spotify API\n- Genius API\n\n### What's next for Scope?\n\n- Add/improve sharing functionality\n- Add suggestions\n- Add more intents/interactions\n- Add Scope for other media - movies/TV/quotes etc.\n\n\u003e _Do you fools listen to music or do you just skim through it? - JAY-Z_\n\n---\n\n### Environment variables\n\n- SPOTIFY_CLIENT_ID\n- SPOTIFY_CLIENT_SECRET\n- GENIUS_ACCESS_TOKEN\n- PAGE_ACCESS_TOKEN\n\n### Running locally (with hot reloading)\n\n1. Set environment variables listed above\n1. Configure event in [/src/test.ts](./src/test.ts) (see [/src/LexEvent.ts](./src/LexEvent.ts) for event structure)\n1. `yarn run test`\n\n### Deployment/Infrastructure\n\nRefer to the [/infrastructure](./infrastructure) directory.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjch254%2Fscope-lex-handler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjch254%2Fscope-lex-handler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjch254%2Fscope-lex-handler/lists"}