{ "_id": "6acac26efe5cc25786e8bdea", "Package": "scopusflow", "Title": "A Reproducible Workflow Layer for 'Scopus' Bibliographic\nSearches", "Version": "0.4.0", "Authors@R": "person(\"Pablo\", \"Bernabeu\", , \"pcbernabeu@gmail.com\", role = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0003-1083-2460\"))", "Description": "A coherent, quota-aware workflow layer over the Elsevier\n'Scopus' Search 'API' .\nIt builds reproducible search plans, retrieves records with\nrate-limit handling, retry with back-off and optional resumable\ncaching, normalises results to a stable tidy schema, extracts\nand tracks changes in Digital Object Identifiers (DOIs), sizes\nsets of concepts and their intersections, compares publication\ntrends across topics, writes the search up as a reproducible\nrecord for a methods section following the 'PRISMA-S' reporting\nstandard (Rethlefsen and others, 2021)\n and exports to formats\ncompatible with downstream bibliometric tools. Network and\n'API' errors are surfaced as typed conditions so that callers\ncan respond to them programmatically. 'Scopus' is a trademark\nof Elsevier. This package is an independent client and is not\naffiliated with or endorsed by Elsevier.", "License": "MIT + file LICENSE", "URL": "https://github.com/pablobernabeu/scopusflow,\nhttps://pablobernabeu.github.io/scopusflow/", "BugReports": "https://github.com/pablobernabeu/scopusflow/issues", "VignetteBuilder": "knitr", "Config/testthat/edition": "3", "Encoding": "UTF-8", "LazyData": "true", "Language": "en-GB", "Roxygen": "list(markdown = TRUE)", "Config/roxygen2/version": "8.0.0", "Config/pak/sysreqs": "libssl-dev", "Repository": "https://pablobernabeu.r-universe.dev", "Date/Publication": "2026-10-10 20:44:52 UTC", "RemoteUrl": "https://github.com/pablobernabeu/scopusflow", "RemoteRef": "HEAD", "RemoteSha": "d001234fa38433fc213a24f88773c9423e601242", "NeedsCompilation": "no", "Packaged": { "Date": "2026-10-10 22:49:07 UTC", "User": "root" }, "Author": "Pablo Bernabeu [aut, cre] (ORCID:\n)", "Maintainer": "Pablo Bernabeu ", "_user": "pablobernabeu", "_type": "src", "_file": "scopusflow_0.4.0.tar.gz", "_fileid": "https://r2.ropensci.org/17a977eef62777b1efad282355757cb093d9cb8317475e3c1808417adf730791", "_filesize": 1614394, "_sha256": "17a977eef62777b1efad282355757cb093d9cb8317475e3c1808417adf730791", "_expires": "2027-01-18T22:55:40.000Z", "_created": "2026-10-10T22:49:07.000Z", "_published": "2026-10-14T19:05:13.360Z", "_buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336", "_status": "success", "_host": "GitHub-Actions", "_jobs": [ { "job": 114332656959, "time": 146, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "ERROR", "artifact": "11684179147" }, { "job": 114332656911, "time": 157, "config": "linux-release-x86_64", "r": "4.6.1", "check": "ERROR", "artifact": "11684881186" }, { "job": 114332656909, "time": 142, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "11684956119" }, { "job": 114332656950, "time": 122, "config": "macos-release-arm64", "r": "4.6.1", "check": "OK", "artifact": "11685140917" }, { "job": 114331845521, "time": 276, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "11684593231" }, { "job": 114332656892, "time": 98, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "11685175580" }, { "job": 114332657007, "time": 136, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "11685250444" }, { "job": 114332656965, "time": 137, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "11684658423" }, { "job": 114332656938, "time": 91, "config": "windows-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "11684248872" } ], "_upstream": "https://github.com/pablobernabeu/scopusflow", "_commit": { "id": "d001234fa38433fc213a24f88773c9423e601242", "author": "Pablo Bernabeu ", "committer": "Pablo Bernabeu ", "message": "Cite the DOI CRAN assigned, in place of the Zenodo concept DOI\n\ncitation(\"scopusflow\"), the About article, the site's sidebar, the README badge\nand CITATION.cff gave the Zenodo concept DOI, 10.5281/zenodo.21252669. The\npackage's CRAN page gives 10.32614/CRAN.package.scopusflow, and R's citation()\ngenerates that DOI for any CRAN package without a CITATION file, so the package\ncirculated under two DOIs and its citations were split between them.\n\nThey now give the CRAN DOI. It is registered with Crossref, resolves to the CRAN\npage and returns full metadata, so a reference manager can import the reference\nfrom the DOI alone, as it can from the Zenodo one. It names the package across\nall its versions, and the version in the note still identifies the release\ncited. Zenodo still archives every GitHub release. The About article's archival\nsection names its concept DOI, and CITATION.cff lists both DOIs under\nidentifiers, with the CRAN page as the repository artifact. lexsync already\ncites its R package this way.\n\nThe sidebar shows the DOI as text that can wrap, as lexsync's does. The README\nbadge, which pkgdown also places under Dev status, is a static shields.io badge\nof the CRAN DOI. Installed copies print the new DOI from the next CRAN release,\nand the website changes when it is next deployed.\n\nVerified: utils::readCitationFile() parses the file and formats the CRAN DOI and\npage, the About article's R chunks parse, spelling::spell_check_package() flags\nnothing (as on main), cffconvert validates CITATION.cff against schema 1.2.0,\nand _pkgdown.yml parses.\n\nCo-Authored-By: Claude Opus 5.5 \nClaude-Session: https://claude.ai/code/session_013sT8wNvpPHPmTkodkDri7E\n", "time": 1791665092 }, "_maintainer": { "name": "Pablo Bernabeu", "email": "pcbernabeu@gmail.com", "login": "pablobernabeu", "linkedin": "in/pablobernabeu", "orcid": "0000-0003-1083-2460", "description": "As a cognitive psychologist and linguist, I conduct research and data analysis on digitally-enhanced childhood learning, language and perception.\n\nSSI Fellow ", "uuid": 20436359 }, "_distro": "resolute", "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.1.0", "role": "Depends" }, { "package": "cli", "role": "Imports" }, { "package": "httr2", "version": ">= 1.0.4", "role": "Imports" }, { "package": "jsonlite", "role": "Imports" }, { "package": "rlang", "version": ">= 1.1.0", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "tibble", "role": "Imports" }, { "package": "tools", "role": "Imports" }, { "package": "utils", "role": "Imports" }, { "package": "bslib", "role": "Suggests" }, { "package": "callr", "role": "Suggests" }, { "package": "fansi", "role": "Suggests" }, { "package": "ggplot2", "role": "Suggests" }, { "package": "grid", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "shiny", "role": "Suggests" }, { "package": "spelling", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "withr", "role": "Suggests" } ], "_owner": "pablobernabeu", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-24", "n": 13 }, { "week": "2026-25", "n": 5 }, { "week": "2026-26", "n": 10 }, { "week": "2026-27", "n": 3 }, { "week": "2026-28", "n": 27 }, { "week": "2026-29", "n": 7 }, { "week": "2026-30", "n": 5 }, { "week": "2026-31", "n": 5 }, { "week": "2026-32", "n": 3 }, { "week": "2026-33", "n": 4 }, { "week": "2026-34", "n": 5 }, { "week": "2026-40", "n": 11 }, { "week": "2026-41", "n": 3 } ], "_tags": [ { "name": "v0.1.0", "date": "2026-06-14" }, { "name": "v0.2.0", "date": "2026-07-10" }, { "name": "v0.2.1", "date": "2026-07-14" }, { "name": "v0.3.0", "date": "2026-07-23" }, { "name": "v0.4.0", "date": "2026-08-23" } ], "_topics": [ "bibliometrics", "literature-review", "reproducible-research", "scopus" ], "_stars": 0, "_contributors": [ { "user": "pablobernabeu", "count": 98, "uuid": 20436359 } ], "_userbio": { "uuid": 20436359, "type": "user", "name": "Pablo Bernabeu", "followers": 30, "description": "As a cognitive psychologist and linguist, I conduct research and data analysis on digitally-enhanced childhood learning, language and perception.\r\n\r\nSSI Fellow " }, "_downloads": { "count": 398, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/scopusflow" }, "_devurl": "https://github.com/pablobernabeu/scopusflow", "_pkgdown": "https://pablobernabeu.github.io/scopusflow/", "_searchresults": 42, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/manual.pdf", "extra/NEWS.html", "extra/NEWS.txt", "extra/readme.html", "extra/readme.md", "extra/scopusflow.html", "LICENSE" ], "_homeurl": "https://github.com/pablobernabeu/scopusflow", "_realowner": "pablobernabeu", "_cranurl": true, "_releases": [ { "version": "0.1.0", "date": "2026-06-20" }, { "version": "0.4.0", "date": "2026-08-21" } ], "_exports": [ "as_bibliometrix", "as_bibtex", "as_ris", "is_scopus_plan", "is_scopus_records", "plot_scopus_comparison", "plot_scopus_intersections", "plot_scopus_top", "plot_scopus_trend", "read_scopus_records", "run_app", "scopus_abstract", "scopus_cache_clear", "scopus_cache_dir", "scopus_combine", "scopus_compare_topics", "scopus_corpus", "scopus_count", "scopus_diff_dois", "scopus_extract_dois", "scopus_fetch", "scopus_fetch_plan", "scopus_field_tags", "scopus_has_key", "scopus_intersections", "scopus_plan", "scopus_query", "scopus_quota", "scopus_records", "scopus_search_report", "scopus_top", "scopus_trend", "write_scopus_records" ], "_datasets": [ { "name": "example_records", "title": "A worked example harvest, in the shape 'Scopus' records take", "object": "example_records", "class": [ "scopus_records", "tbl_df", "tbl", "data.frame" ], "fields": [ "entry_number", "scopus_id", "doi", "title", "authors", "year", "date", "publication", "citations", "query" ], "rows": 138, "table": true, "tojson": true } ], "_help": [ { "page": "as_bibliometrix", "title": "Convert records to a bibliometrix-compatible data frame", "topics": [ "as_bibliometrix" ] }, { "page": "as_bibtex", "title": "Export records to BibTeX or RIS", "topics": [ "as_bibtex", "as_ris" ] }, { "page": "scopus_records", "title": "Normalise raw 'Scopus' entries to a stable tidy schema", "topics": [ "as.data.frame.scopus_records", "as_tibble.scopus_records", "autoplot.scopus_records", "is_scopus_records", "scopus_records" ] }, { "page": "example_records", "title": "A worked example harvest, in the shape 'Scopus' records take", "topics": [ "example_records" ] }, { "page": "plot_scopus_comparison", "title": "Plot a topic comparison", "topics": [ "autoplot.scopus_comparison", "plot_scopus_comparison" ] }, { "page": "plot_scopus_intersections", "title": "Plot concept and intersection sizes", "topics": [ "autoplot.scopus_intersections", "plot_scopus_intersections" ] }, { "page": "plot_scopus_top", "title": "Plot the most frequent values in a record set", "topics": [ "autoplot.scopus_top", "plot_scopus_top" ] }, { "page": "plot_scopus_trend", "title": "Plot a publication trend", "topics": [ "autoplot.scopus_trend", "plot_scopus_trend" ] }, { "page": "run_app", "title": "Launch the scopusflow app", "topics": [ "run_app" ] }, { "page": "scopus_abstract", "title": "Retrieve abstracts and richer metadata", "topics": [ "scopus_abstract" ] }, { "page": "scopus_cache_clear", "title": "Clear the scopusflow managed cache", "topics": [ "scopus_cache_clear" ] }, { "page": "scopus_cache_dir", "title": "Managed cache directory for scopusflow", "topics": [ "scopus_cache_dir" ] }, { "page": "scopus_combine", "title": "Combine record sets into one", "topics": [ "c.scopus_records", "scopus_combine" ] }, { "page": "scopus_compare_topics", "title": "Compare publication trends across topics", "topics": [ "scopus_compare_topics" ] }, { "page": "scopus_corpus", "title": "Assemble a minimal, cross-tool corpus with keywords and references", "topics": [ "scopus_corpus" ] }, { "page": "scopus_count", "title": "Count 'Scopus' results for a query", "topics": [ "scopus_count" ] }, { "page": "scopus_diff_dois", "title": "Compare two DOI retrievals", "topics": [ "scopus_diff_dois" ] }, { "page": "scopus_extract_dois", "title": "Extract, clean and optionally export DOIs", "topics": [ "scopus_extract_dois" ] }, { "page": "scopus_fetch", "title": "Fetch 'Scopus' records for a query", "topics": [ "scopus_fetch" ] }, { "page": "scopus_fetch_plan", "title": "Execute a 'Scopus' search plan, with optional caching and resume", "topics": [ "scopus_fetch_plan" ] }, { "page": "scopus_field_tags", "title": "Recognised 'Scopus' field tags", "topics": [ "scopus_field_tags" ] }, { "page": "scopus_has_key", "title": "Locate the 'Scopus' API key and institutional token", "topics": [ "scopus_has_key" ] }, { "page": "scopus_intersections", "title": "Count a set of concepts and their intersections", "topics": [ "scopus_intersections" ] }, { "page": "scopus_plan", "title": "Build a reproducible 'Scopus' search plan", "topics": [ "is_scopus_plan", "scopus_plan" ] }, { "page": "scopus_query", "title": "Build a field-tagged 'Scopus' query", "topics": [ "scopus_query" ] }, { "page": "scopus_quota", "title": "Parse 'Scopus' quota and rate-limit headers", "topics": [ "scopus_quota" ] }, { "page": "scopus_search_report", "title": "Assemble a reproducible record of a 'Scopus' search", "topics": [ "format.scopus_search_report", "print.scopus_search_report", "scopus_search_report" ] }, { "page": "scopus_top", "title": "Most frequent values in a record set", "topics": [ "scopus_top" ] }, { "page": "scopus_trend", "title": "Annual publication counts for a query", "topics": [ "scopus_trend" ] }, { "page": "summary.scopus_records", "title": "Summarise a set of 'Scopus' records", "topics": [ "summary.scopus_records" ] }, { "page": "write_scopus_records", "title": "Read and write 'Scopus' record sets", "topics": [ "read_scopus_records", "write_scopus_records" ] } ], "_pkglogo": "https://github.com/pablobernabeu/scopusflow/raw/HEAD/man/figures/logo.png", "_readme": "https://github.com/pablobernabeu/scopusflow/raw/HEAD/README.md", "_rundeps": [ "askpass", "cli", "curl", "glue", "httr2", "jsonlite", "lifecycle", "magrittr", "openssl", "pillar", "pkgconfig", "R6", "rlang", "sys", "tibble", "utf8", "vctrs", "withr" ], "_vignettes": [ { "source": "about.Rmd", "filename": "about.html", "title": "About", "engine": "knitr::rmarkdown", "headings": [ "Citing scopusflow", "The developer", "Licence", "Versioning and archival", "Contributing and support" ], "created": "2026-07-03 08:06:01", "modified": "2026-10-10 20:44:52", "commits": 9 }, { "source": "analysing-a-literature.Rmd", "filename": "analysing-a-literature.html", "title": "Analysing and visualising a literature", "engine": "knitr::rmarkdown", "headings": [ "What is in a record set", "How a literature grows", "Where a niche sits", "Reading the fuller record", "Beyond five thousand records" ], "created": "2026-06-20 15:36:20", "modified": "2026-10-03 05:26:37", "commits": 16 }, { "source": "keywords-and-references.Rmd", "filename": "keywords-and-references.html", "title": "Author keywords and references", "engine": "knitr::rmarkdown", "headings": [ "Author keywords from a search", "References via Abstract Retrieval", "A minimal, cross-tool corpus" ], "created": "2026-07-03 12:18:12", "modified": "2026-10-03 11:27:16", "commits": 11 }, { "source": "building-a-reference-set.Rmd", "filename": "building-a-reference-set.html", "title": "Building and exporting a reference set", "engine": "knitr::rmarkdown", "headings": [ "Take stock first", "A clean, deduplicated DOI list", "Into a reference manager", "Handing off to science mapping", "Saving the working set" ], "created": "2026-06-14 14:35:32", "modified": "2026-10-03 12:53:43", "commits": 13 }, { "source": "comparing-topics.Rmd", "filename": "comparing-topics.html", "title": "Comparing topics over time", "engine": "knitr::rmarkdown", "headings": [ "What the comparison measures", "The shape of the result", "A first plot", "When lines converge at the right end", "Drawing the eye to one topic", "Adjusting the labels", "Reading the result as a table" ], "created": "2026-06-14 13:47:22", "modified": "2026-08-20 23:05:48", "commits": 13 }, { "source": "designing-queries.Rmd", "filename": "designing-queries.html", "title": "Designing precise queries across disciplines", "engine": "knitr::rmarkdown", "headings": [ "Field tags decide where to look", "One term, many disciplines", "Combining terms with boolean operators", "Phrases", "Brackets in a query written by hand", "From a query to a plan", "Searching by affiliation", "When a term is empty", "Checks before any request", "Checking recall against known records" ], "created": "2026-06-14 14:35:32", "modified": "2026-10-03 08:52:23", "commits": 10 }, { "source": "scopusflow.Rmd", "filename": "scopusflow.html", "title": "Get started", "engine": "knitr::rmarkdown", "headings": [ "Describing a search as a plan", "Sizing and fetching", "The record schema", "Most frequent sources and authors", "DOIs and change tracking", "Comparing topic trends", "Author keywords and references", "Export and interoperability", "Writing the search up", "Handling failures" ], "created": "2026-06-13 20:43:47", "modified": "2026-08-20 23:05:48", "commits": 15 }, { "source": "plans-and-quota.Rmd", "filename": "plans-and-quota.html", "title": "Search plans and quota-aware retrieval", "engine": "knitr::rmarkdown", "headings": [ "A query, built safely", "Describing the search as a plan", "Why page size is a quota decision", "Sizing before spending", "Fetching, with caching and resume", "Watching progress", "Combining separate retrievals", "Writing the search up", "When the ceiling bites", "Handling interruptions" ], "created": "2026-06-14 13:47:22", "modified": "2026-10-08 22:38:46", "commits": 15 }, { "source": "tracking-literature-change.Rmd", "filename": "tracking-literature-change.html", "title": "Tracking how a literature changes between retrievals", "engine": "knitr::rmarkdown", "headings": [ "The baseline", "A later retrieval", "What changed", "Merging without duplicates", "Keeping a record of each pull" ], "created": "2026-06-14 14:35:32", "modified": "2026-08-20 23:05:48", "commits": 10 }, { "source": "using-the-app.Rmd", "filename": "using-the-app.html", "title": "Using the code-free app", "engine": "knitr::rmarkdown", "headings": [ "Launching the app", "Demo mode", "Describing and sizing a search", "Fetching, with a live terminal", "The reproducible code panel", "Reading the results", "Comparing topics", "Exporting", "Beyond the app" ], "created": "2026-06-22 19:58:01", "modified": "2026-10-03 05:26:37", "commits": 11 } ], "_score": 6.436162647040756, "_indexed": true, "_nocasepkg": "scopusflow", "_universes": [ "pablobernabeu" ], "_progress_url": "https://github.com/r-universe/pablobernabeu/actions/runs/38620641147", "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.4.0", "date": "2026-10-10T22:51:13.000Z", "distro": "resolute", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/fa9c10be2949ec11673759c423611f650683b4b125321406272f11eed0460286", "status": "failure", "check": "ERROR", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.6.1", "os": "linux", "version": "0.4.0", "date": "2026-10-10T22:51:15.000Z", "distro": "resolute", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/c91c51c3a33f8635a1ad137b0a0d89f4c3700c58445ad39c46c426bb9d259c65", "status": "failure", "check": "ERROR", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.5.3", "os": "mac", "version": "0.4.0", "date": "2026-10-10T22:53:51.000Z", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/55d828034298865b9187555eb26ac1e6cf5399fb07d02758df83a8f9085021ff", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.6.1", "os": "mac", "version": "0.4.0", "date": "2026-10-10T22:54:35.000Z", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/c7e185767d5299ded253d1ee48d45397ce2c7c1748bfae169be3fbb9e45ebfc7", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.6.0", "os": "wasm", "version": "0.4.0", "date": "2026-10-10T22:51:09.000Z", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/0e3f5be4fbb2e07372110bd578a2adaba869c202eacc7fd58daa8399b100e63b", "status": "success", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.7.0", "os": "win", "version": "0.4.0", "date": "2026-10-10T22:50:29.000Z", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/55d2bacc8f4fd2c044dea163b7e4053bc2c50272722c3e0932ab1e0033a5e1ac", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.5.3", "os": "win", "version": "0.4.0", "date": "2026-10-10T22:50:24.000Z", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/67c0eec784326c653a6cdc0a14b8f793bd3f50f587c9c30f407363c2a5f2e443", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" }, { "r": "4.6.1", "os": "win", "version": "0.4.0", "date": "2026-10-10T22:50:18.000Z", "commit": "d001234fa38433fc213a24f88773c9423e601242", "fileid": "https://r2.ropensci.org/faeecd3b65d2cba3bb3423b0e974472804ea2688d7d629917ea65879f37c65b7", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/pablobernabeu/actions/runs/38092546336" } ] }