{"id":16510594,"url":"https://github.com/wragge/trovebot","last_synced_at":"2025-03-02T07:43:59.849Z","repository":{"id":13350827,"uuid":"16038144","full_name":"wragge/trovebot","owner":"wragge","description":null,"archived":false,"fork":false,"pushed_at":"2014-04-20T09:50:46.000Z","size":176,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-12T20:08:23.103Z","etag":null,"topics":["code4lib","troveaustralia","twitter-bot"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wragge.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}},"created_at":"2014-01-19T01:54:34.000Z","updated_at":"2015-02-13T02:05:47.000Z","dependencies_parsed_at":"2022-09-04T10:52:21.425Z","dependency_job_id":null,"html_url":"https://github.com/wragge/trovebot","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/wragge%2Ftrovebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wragge%2Ftrovebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wragge%2Ftrovebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wragge%2Ftrovebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wragge","download_url":"https://codeload.github.com/wragge/trovebot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241476425,"owners_count":19968916,"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":["code4lib","troveaustralia","twitter-bot"],"created_at":"2024-10-11T15:56:04.360Z","updated_at":"2025-03-02T07:43:59.820Z","avatar_url":"https://github.com/wragge.png","language":"Python","readme":"trovebot\n============\n\nTweeting content from the following Trove zones:\n\n* Journals, articles and data sets\n* Books\n* Pictures, photos, and objects\n* Music, sound, and video\n* Maps\n* Diaries, letters, and archives\n\nSee me in action at [@TroveBot](http://twitter.com/trovebot).\n\nFor digitised newspapers see [@TroveNewsBot](http://twitter.com/trovenewsbot).\n\nBuilt using the [Trove API](http://trove.nla.gov.au/general/api), the Twitter API, and the [AlchemyAPI](http://www.alchemyapi.com/).\n\n### Making a bot query\n\nSimply tweet some keywords or a url to TroveBot. If it's a url, TroveBot will use AlchemyAPI to extract keywords from the page.\n\nTroveBot will look across Trove zones to see where there are matches. It'll then choose a zone at random and return the most relevant result.\n\n### Modifying your bot query\n\nTo limit your query to a particular zone or format, simply add one of these facets to your tweet:\n\n* #artwork ('Art work' facet in the picture zone) \n* #article (anything in the article zone)\n* #chapter ('Article/Book chapter' facet in the article zone)\n* #paper ('Article/Conference paper' facet in article zone)\n* #report ('Article/Report' facet in article zone)\n* #review ('Article/Review' facet in article zone)\n* #book (anything in the book zone)\n* #proceedings ('Conference Proceedings' facet in book zone)\n* #data ('Data set' facet in article zone)\n* #map (anything in the map zone)\n* #object ('Object' facet in picture zone)\n* #periodical ('Periodical', 'Periodical/Journal, magazine, other', 'Periodical/Newspaper' facets in article zone\n* #photo ('Photograph' facet in picture zone)\n* #picture (anything in picture zone)\n* #poster ('Poster, chart, other' facet in picture zone)\n* #archives (anything in the archives zone)\n* #score ('Printed music' facet in the music zone)\n* #sound (anything in the music zone)\n* #interview ('Sound/Interview, lecture, talk' facet in the music zone)\n* #music ('Sound/Recorded music' facet in the music zone)\n* #thesis ('Thesis' facet in the book)\n* #video ('Video' facet in music zone)\n* #abcrn (limit to ABC Radio National content in music zone)\n\nYou can also add the following filters:\n\n* #aus (limit to 'Australian' content)\n* #online (limit to content freely available online)\n\nBoth of these are very metadata quality dependent, so they mightn't always be accurate.\n\nBy default all keywords are required for a match. To change this you can add the #any tag. This will match records that contain *any* of your keywords.\n\nIn theory, your 'keywords' could be anything that works in Trove's simple search box. This includes things like fielded searches -- eg creator:(\"Wragge, Clement\"). \n\n### Random goodness\n\nIf you supply a query TroveBot will normally return the most relevant record it can find. If you want to dig deeper, you can include the #luckydip tag to make the bot deliver a random record from the matching results.\n\nIf you just want to play around without specifying a query, you can:\n\n* include the tag #luckydip by itself to get a random record from somewhere in Trove\n* include one of the facets above by itself to get a random record from that zone/format.\n\n### Examples\n\n* Search for a book matching 'wragge': *@TroveBot wragge #book*\n* Search for an Australian thesis related to a wikipedia page: *@TroveBot http://en.wikipedia.org/wiki/Clement_Lindley_Wragge #thesis #aus*\n* Search for a random photo available online: *@TroveBot #photo #online*\n\n### Automatic botness\n\n* Several times a day TroveBot will tweet a random item.\n\nReleased under CC0 licence.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwragge%2Ftrovebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwragge%2Ftrovebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwragge%2Ftrovebot/lists"}