@xquik/paperclip-plugin-xquik
v0.1.7
Published
Paperclip plugin for Twitter search, tweet lookup, profiles, timelines, and X API trends. Not affiliated with X Corp.
Downloads
372
Maintainers
Readme
Twitter search & X API tools for Paperclip agents
Add 6 read-only Xquik tools to Paperclip agents for Twitter search, tweet lookup, profiles, timelines, and regional trends.
Tools
| Agent task | Paperclip tool | Result |
| --- | --- | --- |
| Search tweets | xquik.search_tweets | Run a Twitter search with query operators. |
| Read one tweet | xquik.lookup_tweet | Get a tweet by ID. |
| Find X users | xquik.search_users | Search by name or username. |
| Read a profile | xquik.get_user | Get public profile data. |
| Read profile tweets | xquik.get_user_tweets | List recent posts from one user. |
| Read regional trends | xquik.get_trends | Get trends by WOEID. |
This plugin does not export followers or publish posts. Use the Xquik API for those tasks.
Configuration
apiBaseUrl: Xquik API endpoint. Defaults tohttps://xquik.com/api/v1.apiKeySecretRef: Paperclip secret reference for the Xquik API key.defaultSearchLimit: Default tweet search limit from 1 to 200.defaultTrendCount: Default trend count from 1 to 50.
Paperclip resolves the API key at call time and sends the x-api-key header.
Install
paperclipai plugin install @xquik/paperclip-plugin-xquikPin the current release when you need reproducible installs:
paperclipai plugin install @xquik/paperclip-plugin-xquik --version 0.1.7Develop locally
pnpm install
pnpm check
pnpm check:reproduciblepnpm check runs type checks, tests at 100% coverage, and the build.
pnpm check:reproducible compares 2 clean builds and package archives. CI checks REUSE 3.3 metadata and dependencies.
API contract
- OpenAPI schema
- API reference
- Organization support policy
- Organization security policy
- Contribution guide
Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.
