{"id":15989265,"url":"https://github.com/robot-inventor/twi-ext","last_synced_at":"2026-03-15T07:02:45.695Z","repository":{"id":210816913,"uuid":"610333635","full_name":"Robot-Inventor/twi-ext","owner":"Robot-Inventor","description":"Unofficial utility to develop browser extensions for Twitter / X","archived":false,"fork":false,"pushed_at":"2025-10-01T01:37:00.000Z","size":1292,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-01T03:33:42.245Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/Robot-Inventor.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-03-06T15:06:31.000Z","updated_at":"2025-10-01T01:35:51.000Z","dependencies_parsed_at":"2025-04-04T18:31:38.331Z","dependency_job_id":"669cb817-7c6e-4b1b-aa25-c58e9885182e","html_url":"https://github.com/Robot-Inventor/twi-ext","commit_stats":null,"previous_names":["robot-inventor/twi-ext"],"tags_count":64,"template":false,"template_full_name":null,"purl":"pkg:github/Robot-Inventor/twi-ext","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Robot-Inventor%2Ftwi-ext","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Robot-Inventor%2Ftwi-ext/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Robot-Inventor%2Ftwi-ext/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Robot-Inventor%2Ftwi-ext/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Robot-Inventor","download_url":"https://codeload.github.com/Robot-Inventor/twi-ext/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Robot-Inventor%2Ftwi-ext/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278441693,"owners_count":25987498,"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","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-08T04:41:14.976Z","updated_at":"2026-03-15T07:02:45.686Z","avatar_url":"https://github.com/Robot-Inventor.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# twi-ext\n\nUnofficial utility to develop browser extensions for Twitter / X.\n\nThis package provides a simple API to interact with the X web interface. It allows you to listen to events such as new posts being added to the timeline, and provides access to the React props of the posts or user profiles.\n\nIt is used to develop [Shadowban Scanner](https://github.com/Robot-Inventor/shadowban-scanner/), a browser extension that helps you detect shadowbans on X, and other extensions.\n\n\u003e [!IMPORTANT]\n\u003e This utility works only within page scripts. Running it within a content script may result in an error.\n\n\u003e [!WARNING]\n\u003e This package is under development and some features are not yet implemented.\n\n## Installation\n\n```bash\nnpm install twi-ext\n```\n\n## Usage\n\n```typescript\nimport { Timeline, Tweet } from \"twi-ext\";\n\nconst onNewTweet = (tweet: Tweet): void =\u003e {\n    // Get the tweet element.\n    const tweetElement = tweet.element;\n    // Get the React props of the tweet.\n    const props = tweet.props;\n};\n\nconst timeline = new Timeline();\ntimeline.onNewTweet((tweet) =\u003e {\n    // Do something when a new tweet is added to the timeline.\n    onNewTweet(tweet);\n});\n```\n\nSee the [documentation](./docs/README.md) for more information.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.\n\n## Development\n\n```bash\nnpm install\n```\n\n### Build\n\nTo build the project and generate the documentation:\n\n```bash\nnpm run build\n```\n\n### Format\n\nTo format the code:\n\n```bash\nnpm run format\n```\n\n### Lint\n\nTo lint the code:\n\n```bash\nnpm run lint\n```\n\n### Pull Requests\n\nThis repository uses [Changesets](https://github.com/changesets/changesets) to manage versioning and releases. When creating a pull request, please run the Changesets CLI and commit the changeset file.\n\n```bash\nnpx changeset\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobot-inventor%2Ftwi-ext","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobot-inventor%2Ftwi-ext","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobot-inventor%2Ftwi-ext/lists"}